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

[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!


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
 - "2.x/" (or maybe just "2/"?) as a redirection to 2.7
 - "3.x/" (or maybe just "3/"?) as a redirection to 3.3

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>/ 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/ !).


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.

Victor