Alias for the latest released version

[vitaut]

It would be nice to have an alias to the latest released version of the documentation. For example, in GitHub you can refer to the latest release with URL like https://github.com/cppformat/cppformat/releases/latest.

In ReadTheDocs latest refers to the latest development documentation which is rarely what user needs, because users usually deal with released versions of software rather than unreleased software from the head of the master branch.

[ericholscher]

Yea, I like the idea of having a latest and a stable that are RTD-controlled versions that you can  point at a specific tag or branch.

[vitaut]

Thanks for adding the stable version, this is very useful. One minor question/suggestion: wouldn't it be more logical to have version labels in (reverse) chronological order as in latest, stable, 2.0, 1.0?Currently latest and stable are swapped: stable, latest, 2.0, 1.0.

[vitaut]

Just to clarify that I'm referring to the order of labels in this view:

[andrewcollette]

It looks like the "stable" version points to the most recently created version tag... unfortunately the most recent tag in my project at the moment is a beta version (2.4.0b1) and "stable" now points to that:

http://docs.h5py.org/en/stable/

The project in question:

https://github.com/h5py/h5py

Would it be possible for "stable" to avoid including alpha/beta/rc release tags? FWIW, my versioning/tag approach follows PEP 440.

[mboersma]

Would it be possible to disable stable altogether? This kind of magic behavior is un-Pythonic and error-prone; it has caused us nothing but grief.

[vitaut]

@mboersma Can't you disable it in Admin/Versions or do you want to force others not to have it?