[Python-ideas] docs.python.org

Jay Wren jrwren at xmtp.net
Mon Oct 29 17:12:56 CET 2012

On Oct 27, 2012, at 8:21 AM, Paul Moore <p.f.moore at gmail.com> wrote:

> On 27 October 2012 12:43, Antoine Pitrou <solipsis at pitrou.net> wrote:
>> On Sat, 27 Oct 2012 12:06:41 +0100
>> Paul Moore <p.f.moore at gmail.com> 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.

More information about the Python-ideas mailing list