[Python-ideas] docs.python.org

Yury Selivanov yselivanov.ml at gmail.com
Sat Oct 27 09:17:41 CEST 2012


On 2012-10-27, at 2:22 AM, Nick Coghlan <ncoghlan at gmail.com> wrote:

> I'm actually wondering if docs.python.org should be updated *now* with
> a rewrite rule that redirects to a more explicit docs.python.org/2.x/
> URL. At the moment, there is no easy way to get hold of a stable URL
> for the Python 2 docs, and nothing we can put in any advance
> announcement of a migration to say something like:
> "docs.python.org will switch to displaying the Python 3 documentation
> by default in June 2013. Please update any direct links that are
> intended to refer specifically to the Python 2 documentation by
> including a leading '/2.x/' in the path component of the URL. For
> example, 'http://docs.python.org/library/os' would become
> 'http://docs.python.org/2.x/library/os'. Between now and the migration
> in June 2013, affected links will be automatically redirected to the
> new stable Python 2.x URLs".
> So that's my concrete proposal:
> 1. We pick a date (June next year sounds about right)
> 2. We pick a stable URL prefix for the Python 2 docs (I vote "/2.x/")
> 3. We start redirecting affected pages immediately
> 4. We add a notice like the one above to the home page of the 2.7
> docs, announce it on the PSF blog, announce it far and wide

Now that's a great plan!

Big +1.

A few comments:

1. I'd still vote for an earlier date, like February/March 2013
2. How about simple docs.pyhton.org/2 and docs.python.org/3 ?


More information about the Python-ideas mailing list