As I understand it,  http://docs.python.org/library redirects to  http://docs.python.org/2/library so that old links, blog posts..... that exist in the world and originally referenced python 2 will still work as they pointed to  http://docs.python.org/library  (no version number)
* Is this correct?

At some point http://docs.python.org/library should stop working.
I would consider adding release numbers, i.e http://docs.python.org/3.4/library

All this makes me think it would be cool to have a DIFF button on document pages that would show a diff between version number. i.e. when I read a blog post about X and I follow the link in the post to doc version a.b I can see a quick diff to see how it (docs) compare to version c.d I am using.

I think http://docs.python.org should be a landing page not forwarded to current version docs. Maybe something like http://www.python.org/doc/versions/ although I think that should be here http://docs.python.org/versions/


Vincent Davis
720-301-3003


On Fri, Jan 31, 2014 at 5:41 AM, Rick Boyce <rickboyce@gmail.com> wrote:
I get caught out a lot by the titles Google is showing for pages quite often too, but as far I can tell they are not related to the /dev docs.

If I Google "python builtins" the top 3 results, for me, are as follows:

2. Built-in Functions — Python v2.7.6 documentation -> http://docs.python.org/library/functions.html
28.3. builtins — Built-in objects — Python 3.3.3 documentation -> https://docs.python.org/3/library/builtins.html
Built-in objects - Python 3.3.3 documentation -> http://docs.python.org/library/__builtin__.html

The top two are fine, but the last one is a Python 2 docs page but Google shows the title as being for 3.3. This seems to be really common when googling for python docs. 

At least the design of the two versions is different enough that you spot it immediately, but it happens often enough to be confusing all the same!

Rick


On 25 January 2014 13:47, Vincent Davis <vincent@vincentdavis.net> wrote:
When I do a google search the version numbers are mismatched with the linked page (or redirected).
For example search for "python counter" I get the following results. (see attachment)
It seems like the website is redirecting incorrectly.

  1. collections - Python 3.3.3 documentation
    1. links to http://docs.python.org/library/collections.html
    2. redirects to http://docs.python.org/2/library/collections.html
    3. Which is python 2.7.6
  2. itertools - Python 3.3.3 documentation
    1. links to http://docs.python.org/library/itertools.html
    2. redirects to http://docs.python.org/2/library/itertools.html
    3. Which is again 2.7.6
  3. 8.3. collections — Container datatypes - Python 3.3.3 documentation
    1. This one seems correct, 3.40b2
    2. links to http://docs.python.org/dev/library/collections
The link to addresses are not really true, they look more like:
https://www.google.com/url?sa=t&rct=j&q=&esrc=s&source=web&cd=1&cad=rja&ved=0CCcQFjAA&url=http%3A%2F%2Fdocs.python.org%2Flibrary%2Fcollections.html&ei=k7vjUqPrHM_jsAS-m4G4Cw&usg=AFQjCNFTyb_RHzPdorBGavEIR_ekNn_AFA&sig2=yW6S02oUEfioUot11lTAlQ&bvm=bv.59930103,d.cWc

Vincent Davis


_______________________________________________
Python-Dev mailing list
Python-Dev@python.org
https://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: https://mail.python.org/mailman/options/python-dev/rickboyce%40gmail.com