[Python-ideas] docs.python.org

[Paul Moore]

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?

Paul