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 _______________________________________________ Python-Dev mailing list Python-Dev@python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
