[Python-Dev] http://docs.python.org/py3k/ pointing to 2.7

[Georg Brandl]

Am 15.04.2011 15:47, schrieb Victor Stinner:
> Le vendredi 15 avril 2011 à 13:34 +0200, Jesus Cea a écrit :
>> http://docs.python.org/py3k/ takes you to 2.7, by default.
>> 
>> Should we update it to point to 3.2?. If the point is to promote Python 3...
>> 
>> I would point it to 3.2, with a big "access to documentation to legacy
>> 2.7" (beside the small left column link). What do you think?.
> 
> http://docs.python.org/ points to 2.7 yes. I'm already reading 3.3 doc
> to develop with Python 2.5: I prefer the most recent doc, and the API is
> usually exactly the same. So I vote +1 to make 3.3 the default doc.
> Anyway, Python 2 is a dead language!

That is exactly the kind of comment that leads to FUD outside of python-dev.
Of course Python 2 is not dead as long as 2.7 is maintained.

As long as we're getting complaints from users that the examples in the
2.7 docs don't work with Python 2.5, there is no way making docs.python.org
show docs for 3.2 is the better choice.

> I don't like URL prefixes to indicate the version: "py3k/" for 3.2 (last
> Python 3 stable version), no prefix for 2.7, "release/2.6.6/" for 2.6,
> "dev/py3k/" for 3.3, etc.
> 
> Can't we keep it simple as:
>  - "2.6/" for 2.6
>  - "2.7/" for 2.7
>  - "3.1/" for 3.1
>  - "3.2/" for 3.2
>  - "3.3/" for 3.3

That we have.

>  - "2.x/" (or maybe just "2/"?) as a redirection to 2.7
>  - "3.x/" (or maybe just "3/"?) as a redirection to 3.3

That we could introduce, if it's really needed.  (We'd need to keep
the old URLs as well as redirections of course, introducing even
more ways to spell things.)

> http://docs.python.org/ may be a redirection (to
> http://docs.python.org/3.x/) instead of directly the doc. So it would be
> intuitive to replace 2 by 3 (or 3 by 2) in the URL.
> 
> 
> The http://www.python.org/doc/versions/ page uses other URLS:
> http://www.python.org/doc/<version>/

These are legacy URLs and are redirected, as you note.

> which are redirections to
> http://docs.python.org/release/<version>/. For example:
> http://www.python.org/doc/3.2/ is a redirection to
> http://docs.python.org/release/3.2/ (which give the same content than
> http://docs.python.org/py3k/ !).

No, they don't.  /release/version docs are those *released with* a specific
version, i.e. frozen at the point of the release. /py3k/ (and /version/)
docs are refreshed daily from the respective branch.

> On the left of http://docs.python.org/, you have links to other versions
> of the doc: 2.6, 3.2, 3.3... but not 3.1. 3.3 doc have links to 2.7 and
> 3.2 (not 2.6 or 3.1). If there is a rule to choose links on the left, I
> don't understand this rule.

3.1 is not really interesting for 2.7 users since 3.2 is out, while 2.6 is
not really interesting for 3.2 users.

Georg