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

[Vasily]

Maybe rename "latest" to "unreleased" or something similar?..

Thanks,
Vasily
29 сент. 2016 г. 8:46 пользователь "Pierre Tardy" <tardyp at gmail.com>
написал:

> 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
>>
>
> _______________________________________________
> 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/59411c57/attachment.html>