[users at bb.net] Confusing documentation links "latest" and "current"

[Pierre Tardy]

Hi Ryan,

There is actually documentation archive for each version e.g
http://docs.buildbot.net/0.8.12/

There is also a big warning in the head of each page of the latest doc
explaining the difference.
We did that to try and remove some of the confusion. its not perfect.

Regards


Le jeu. 29 sept. 2016 à 03:28, Ryan Schmidt <buildbot at ryandesign.com> a
écrit :

> It's confusing that the documentation for the development version of
> Buildbot is at
>
> http://docs.buildbot.net/latest/
>
> while the documentation for the stable version is at
>
> http://docs.buildbot.net/current/
>
> When I search Google and land on a documentation page, I never remember
> which means which. "Latest" and "current" are synonyms:
>
> http://www.thesaurus.com/browse/latest?s=t
>
> http://www.dictionary.com/browse/latest?s=t
>
> How about putting the version number in the URL instead of "latest" and
> "current"? This is what Apache httpd does, e.g.
>
> http://httpd.apache.org/docs/2.0/
> http://httpd.apache.org/docs/2.2/
> http://httpd.apache.org/docs/2.4/
>
> _______________________________________________
> users mailing list
> users at buildbot.net
> https://lists.buildbot.net/mailman/listinfo/users
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.buildbot.net/pipermail/users/attachments/20160929/9624f6f2/attachment.html>