[Buildbot-commits] [Buildbot] #2514: Add cross links in generated documentation between versions of Buildbot

[Buildbot trac]

#2514: Add cross links in generated documentation between versions of Buildbot
------------------------+-----------------------
Reporter:  rutsky       |      Owner:
    Type:  enhancement  |     Status:  new
Priority:  major        |  Milestone:  undecided
 Version:               |   Keywords:  docs, web
------------------------+-----------------------
 If you try to search some documentation page in search engine you often
 will get results for random version of Buildbot documentation.

 For example first links by query "buildbot interlocks" in Google [1] leads
 to 0.8.1 Buildbot documentation [2]; "buildbot CVSMaildirSource" in
 DuckDuckGo [3] leads to 0.8.4p2 version [4].

 It would be nice to have ability to switch to same page (or topic) of
 documentation for other Buildbot version (IMO, last stable release and
 master branch documentation required more often).

 Such functionality exists in Boost [5] documentation: pages of
 documentation for old releases have link on the same page in latest stable
 release, for example here [6] at top of the page you can see link "Click
 here to view the latest version of this page".

 This of course is actual only for published on site documentation.

 [1] https://encrypted.google.com/search?q=buildbot%20interlocks

 [2] http://docs.buildbot.net/0.8.1/Interlocks.html

 [3] https://duckduckgo.com/?q=buildbot+CVSMaildirSource

 [4] http://docs.buildbot.net/0.8.4p2/CVSMaildirSource.html

 [5] http://www.boost.org

 [6] http://www.boost.org/doc/libs/1_49_0/libs/geometry/doc/html/index.html

-- 
Ticket URL: <http://trac.buildbot.net/ticket/2514>
Buildbot <http://buildbot.net/>
Buildbot: build/test automation