Have copies of docs at stable/ and dev/

[lilyminium]

Fixes #2966 (kind of)*

Changes made in this Pull Request:

• Copies the latest release to https://docs.mdanalysis.org/stable/
• Copies latest dev docs to https://docs.mdanalysis.org/dev
• Allows docs to be intersphinxed at above URLs

It will hopefully look like the way docs behave at https://minium.com.au/mdanalysis/ . In short:

• https://minium.com.au/mdanalysis/ redirects to https://minium.com.au/mdanalysis/stable
• https://minium.com.au/mdanalysis/documentation_pages/topology/GSDParser redirects to https://minium.com.au/mdanalysis/stable/documentation_pages/topology/GSDParser.html
• https://minium.com.au/mdanalysis/1.0.0/ is the exact same docs but at a different URL
• https://minium.com.au/mdanalysis/dev/ is the same docs as https://minium.com.au/mdanalysis/2.0.0-dev0/ at a different URL
• https://minium.com.au/mdanalysis/latest redirects to https://minium.com.au/mdanalysis/1.0.0 because I set up the "latest" endpoint earlier and am not sure if it will break anything if we remove it

This doubling up of docs is based off numpy behaviour, i.e. https://numpy.org/doc/stable/ appears to be the same docs as https://numpy.org/doc/1.19/ . If it's too redundant, we could remove the 1.0.0 and 2.0.0-dev0 entries and just keep stable and dev.

* I manually made the "stable" docs for 1.0.0 because master has moved onto 1.0.1-dev, but the "stable" docs in https://minium.com.au/mdanalysis/ were made by changing the version to "1.0.0" (hence the different date for when they were last built). So https://docs.mdanalysis.org/stable/index.html already exists despite not merging this yet.

Edit: this should go into master as well because it changes the behaviour of the "dev/" URL.

PR Checklist

• Tests?
• Docs?
• CHANGELOG updated?
• Issue raised/referenced?

[pep8speaks]

Hello @lilyminium! Thanks for updating this PR. We checked the lines you've touched for PEP 8 issues, and found:

• In the file maintainer/update_json_stubs_sitemap.py:

Line 118:80: E501 line too long (87 > 79 characters)
Line 119:80: E501 line too long (92 > 79 characters)

Comment last updated at 2020-10-05 06:38:43 UTC

[codecov]

Codecov Report

Merging #2968 into develop will decrease coverage by 0.02%.
The diff coverage is n/a.

@@             Coverage Diff             @@
##           develop    #2968      +/-   ##
===========================================
- Coverage    93.05%   93.02%   -0.03%     
===========================================
  Files          186      186              
  Lines        24609    24609              
  Branches      3187     3187              
===========================================
- Hits         22900    22893       -7     
- Misses        1661     1668       +7     
  Partials        48       48              

Impacted Files	Coverage Δ
package/MDAnalysis/due.py	66.66% <0.00%> (-8.34%)	⬇️
package/MDAnalysis/coordinates/base.py	94.64% <0.00%> (-0.49%)	⬇️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 542daa9...2a7f38b. Read the comment docs.

[orbeckst]

I agree with your reasoning and decisions – that's the main thing for which I add the 👍 .

From skim-reading the code it was not clear to me if latest in the code refers to "dev" (which is how numpy labels their docs https://numpy.org/doc/). If you could just add a comment (deploy script and update Python script) to add semantics then that would be helpful.