Re: [Python-Dev] docs.python.org pointing to Python 3 by default?
On May 18, 2012, at 2:24 PM, Barry Warsaw wrote: At what point should we cut over docs.python.org to point to the Python 3 documentation by default? Wouldn't this be an easy bit to flip in order to promote Python 3 more better? I would like to suggest a less all-or-nothing approach. Just redirecting to Python 3 docs is going to create a lot of support headaches for people trying to help others learn Python. Right now, e.g. http://docs.python.org/tutorial/index.html directly renders a page. I suggest that this be changed to a redirect to http://docs.python.org/release/2.7/tutorial/index.html. The fact that people can bookmark the default version of a document is kind of a bug. The front page, http://docs.python.org/ could then be changed into a are you looking for documentation for Python 2 or Python 3? page, with nice big click targets for each (an initial suggestion: half the page each, split down the middle, but the web design isn't really the important thing for me). If you want to promote python 3 then putting most recent version links (for example, see http://twistedmatrix.com/documents/10.2.0/api/twisted.internet.defer.inlineCallbacks.html) across the top of all the old versions would be pretty visible. -glyph ___ 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
Re: [Python-Dev] docs.python.org pointing to Python 3 by default?
I would like to suggest a less all-or-nothing approach. Just redirecting to Python 3 docs is going to create a lot of support headaches for people trying to help others learn Python. I don't think this will be that bad. Most Python 3 documentation pages apply to Python 2 as well. There may be features documented that don't exist in Python 2, but it was always the case that users of older Python versions had to watch for the versionadded/versionchanged notices. IMO, it would be good if each individual page had an other versions section on left-hand block, or on the top along with the previous | next links. As for the amount of cross-linking, I suggest the following, assuming 2.7 and 3.3 are the current releases: 1. 2.7 links to 2.6 and 3.3 2. 3.3 links to 3.2 and 2.7 3. all older versions link to newest, i.e. 3.3. I understand that this would require a custom mapping in some cases. It would be best if Sphinx could already consider such a mapping when generating links. Failing that, we can also do the custom mapping in the web server (i.e. with redirects). Regards, Martin ___ 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
Re: [Python-Dev] docs.python.org pointing to Python 3 by default?
On Sun, May 20, 2012 at 4:43 AM, Glyph gl...@twistedmatrix.com wrote: Right now, e.g. http://docs.python.org/tutorial/index.html directly renders a page. I suggest that this be changed to a redirect to http://docs.python.org/release/2.7/tutorial/index.html. The fact that people can bookmark the default version of a document is kind of a bug. I'm -1 on that; unless there's a strong reason to avoid it, bookmarking the default version seems like the right thing to me. (One example of a strong reason would be if all Python modules were numbered sequentially in alphabetical order, meaning that adding a new module changes the URLs of existing modules' pages.) Compare the PostgreSQL documentation: if you do a web search for 'postgres nextval', you'll find the documentation for Postgres's sequence functions (which is correct), but chances are it'll be the old docs - version 8.1 most likely. If there's no weighting toward one in particular, I'd say that returning information for the latest version is the most logical default. Obviously there's more docs difference between Python 2 and Python 3 than between Postgres 8.1 and Postgres 9.1, but the most accessible version of a page should not IMHO distinguish between Python minor versions. ChrisA ___ 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
Re: [Python-Dev] [Python-checkins] cpython: Clean up the PCBuild project files, removing redundant settings and
On Sat, May 19, 2012 at 2:11 PM, kristjan.jonsson python-check...@python.org wrote: +Visual Studio 2010 uses version 10 of the C runtime (MSVCRT9). The executables Shouldn't that be MSVCRT10? Nadeem ___ 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