A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from https://mail.python.org/pipermail/python-dev/2012-May/119597.html below:

[Python-Dev] docs.python.org pointing to Python 3 by default?

[Python-Dev] docs.python.org pointing to Python 3 by default?Terry Reedy tjreedy at udel.edu
Mon May 21 18:18:16 CEST 2012
On 5/21/2012 7:42 AM, Georg Brandl wrote:
> On 05/21/2012 11:09 AM, Łukasz Langa wrote:
>> Wiadomość napisana przez Nick Coghlan w dniu 21 maj 2012, o godz. 09:24:
>>
>>> The following
>>> would be using docs.python.org as a namespace (and is what I think we
>>> should move towards):
>>>
>>> docs.python.org/latest
>>> docs.python.org/dev
>>> docs.python.org/3.2
>>> docs.python.org/3.1
>>> docs.python.org/2.7
>>> docs.python.org/2.6
>>
>> Love it. +1
>
> Apart from the "latest" one, all these URLs already work.
>
> Of course, /2.7 is redirected to /, and /3.3 to /dev, etc.
> If required, the direction of these redirects can be changed, so
> that e.g. / goes to /2.7.
>
> What about:
>
> * Canonical:
>
> docs.python.org/2/
> docs.python.org/3/

If you prefer these to docs2, docs3, OK with me.
Whatever we do, we should encourage book/blog writers to use the 
canonical 'latest' links that will not go out of date. So there should 
definitely be one for each, with the same format. The exact format is 
less important.

> for latest versions of 2.x and 3.x
>
> docs.python.org/2.7/ etc.
>
> for latest minor versions
>
> docs.python.org/dev/
>
> for latest dev version.
>
> * Redirected:
>
> docs.python.org/  -->   either /2/ or /3/ or a "disambiguation page"

While I am a strong partisan of Py 3, I do not want Py 2 users to feel 
'pushed', so I vote for a neutral index or 'disambiguation' page.

What I would do is set up the canonical pages now. Next, add a notice to 
the top of docs.python.org that it will become a neutral index page with 
the release of 3.3, so 'please change bookmarks to the new, permanent 
page for Py 2', whatever it is.

> docs.python.org/py3k/ ->  /3/

> There is also /release/X.Y.Z for individual released versions, which
> I don't want to change.

I would leave those alone too.

-- 
Terry Jan Reedy


More information about the Python-Dev mailing list

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4