Description
On these urls:
- http://api.jqueryui.com/button/
- http://api.jqueryui.com/1.9/button/
- http://api.jqueryui.com/1.8/button/
It is hard to determine on which site you currently are. The version is only exposed in 1 place (the site name) which is currently reflected in 3 spots:
document.title(it appends " | sitename" to the title)
→ Not visible in tabbed browsers that show the begin of the title only (e.g. in Chrome the tab reads: "Button | jQuery UI A...")- Browser address bar
→ It is visible, but though we are facing a technologically more advanced audience, imho this is not a valid way to communicate something like this. - Search bar placeholder
→ Again, this is visible but, aside from Search form placeholder for jQuery UI sites too long #233, this is also not an intuitive place to look. It happens to include the site name which includes the version.
Screenshot of documentation written for jQuery UI 1.9:
It is imho also counter-intuitive that the main menu bar (where "API Documetation" is highlighted) is version-neutral, whereas the sidebar is in fact specific to the current site. Perhaps the sidebar should output the sitename above that list, and then show the other sibling sites in the list as well? Basically like an accordeon (latest, 1.9, 1.8, and for the current one highlight it and list the categories below).
Screenshot of canonical version (currently written for jQuery UI 1.10):
In the latter case it is even worse as it really doesn't mention relevance to 1.10 anywhere (the footer mentions that latest stable version is 1.10.3, but it says "1.10.3" on the 1.8 and 1.9 sites as well).