On Oct 27, 2012, at 8:21 AM, Paul Moore
On 27 October 2012 12:43, Antoine Pitrou
wrote: On Sat, 27 Oct 2012 12:06:41 +0100 Paul Moore
wrote: Another idea is similar, but instead of doing /2.x/ always redirect the the root of docs.python.org to the latest production release, so right now /foo would redirect to /2.7/foo. This is even better for maintaining links to the actual resource people meant to link to. Could even include a header at the top of old versions saying that "You are currently viewing the docs for 2.5. Click here to view the docs for 2.7".
-1. Certainly what I (and I suspect many others) usually care about is getting at the "Python 2" or "Python 3" documentation, not a specific version. Having the 2.7, 2.6 links is fine, but I don't *think* of myself as going to the 2.7 docs, but rather to the 2.x docs (as opposed to 3.x). The "New in x.y" annotations give me the history I need. And I think that's true of links as well - they would be to "python 2" or "python 3", not (normally) to a specific minor version.
I'm not sure why you're -1 about something which wouldn't affect you negatively. As you say yourself, the 2.7 docs have all the information you need about previous releases as well (because of the versionadded and versionchanged markers). *However*, the 2.6 and previous docs don't have information about useful stuff added in 2.7.
Maybe I misunderstood. I was assuming that there would be no "2.x" link, only "2.7". That's what I'm against - I would prefer to use a generic 2.x link to get to the Python 2 docs if I needed them (just as I use docs.python.org at the moment).
My -1 was too strong though, make that a -0 (and a "don't care" if there will be a 2.x link as well as the explicit ones).
And since 2.7 is the last in the 2.x line, I think it makes sense to reflect that explicitly in the redirections.
I'm not against an explicit 2.7 link - we have that already, don't we?
Did this change recently? I just noticed that from http://www.python.org/doc/ if I click "Browse Current Documentation" under then Python 2.x section, it links to docs.python.org which then redirects to docs.python.org/3/ which is NOT the 2.x current documentation for which I clicked. -- Jay