Molecule: [Documentation] Show latest stable version of documentation

[Lirt]

Issue Type

Molecule documentation by default shows latest (2.20x) docs instead of stable (2.19x).

Desired Behavior

Since majority of people are using latest stable version (2.19) of molecule (distributed officially by pip, docker or package managers), we should by default show this (stable) version of documentation.

Actual Behaviour

Documentation showed is for latest branch (master, or pre-release?), which is used only by small portion of users. This can lead people to using features, that are not currently implemented, or merged into oficially distributable release, that most of the people are using. (as I fooled myself today with cleanup feature).

[decentral1se]

Yeah, I actually think this is really important @Lirt! A number of reports have been confusing because the reporter was using latest vs. 2.19 or whatever and I think we should definitely avoid this.

@gundalow do you have access permissions for this?

I don't see a configurable in https://github.com/ansible/molecule/blob/master/.readthedocs.yml for this.

[decentral1se]

Regarding the final paragraph in https://github.com/ansible/molecule/issues/1849#issuecomment-476153969, I am wondering if there is a tradition of latest in the world of RTD referring to latest stable? I am not sure what we want to do here (maybe match our docker tags convention!?) but let's keep that in mind.

[Lirt]

I was also thinking about the naming convention that we were discussing in docker tags issue.

I think it would be great to follow the same convention here.

[decentral1se]

Here's an example where this bit us: https://github.com/ansible/molecule/issues/1845.

[decentral1se]

ping @gundalow, any idea how we can get this done?

[gundalow]

Currently, Molecule doesn't have any branches
RTD's displays what's in branch master

[gundalow]

Might be able to use https://docs.readthedocs.io/en/stable/versions.html so we just use the last tagged version.

[gundalow]

Hi,

I've set stable as the default doc when you visit molecule.readthedocs.org

So today that means stable = 99e03ea1, which is the SHA of 2.20, which is the current release.

@Lirt Does that seem good to you?

[Lirt]

Hi @gundalow,

it loads stable version for me by default, so I guess it is good now.

Thank you.

[decentral1se]

Maximum stoke, thanks all!