Accepted Solution
- Hide the dev docs in stable builds w/ link to the latest, show in dev builds (this is what Sunpy does right now)
Original Post
This came out of suggestions by both @aarchiba and @Cadair - one issue with the developer documentation at the moment is that the version at 'stable' (the default which people will see) might be out of date by up to 6 months. The easiest solution (which is what SunPy does) would be to basically remove the developer docs in release branches (and therefore the stable branch) and keep the dev docs in 'latest'. Then when going to the stable docs or any fixed release docs, instead of:
users would see:
and clicking on the link would take them to:
in the latest developer docs. Any objections to this?
Accepted Solution
Original Post
This came out of suggestions by both @aarchiba and @Cadair - one issue with the developer documentation at the moment is that the version at 'stable' (the default which people will see) might be out of date by up to 6 months. The easiest solution (which is what SunPy does) would be to basically remove the developer docs in release branches (and therefore the stable branch) and keep the dev docs in 'latest'. Then when going to the stable docs or any fixed release docs, instead of:
users would see:
and clicking on the link would take them to:
in the latest developer docs. Any objections to this?