[Python-ideas] docs.python.org

Yury Selivanov yselivanov.ml at gmail.com
Fri Oct 26 20:09:43 CEST 2012


On 2012-10-26, at 2:04 PM, Christian Heimes <christian at python.org> wrote:

> Am 26.10.2012 19:56, schrieb Bruce Leban:
>> There are tons of links out there that would break if you switched to
>> docs2 and docs3. JS is better. And it would accommodate a feature where
>> a user can set a preference of what version of python documentation they
>> want to see rather than defaulting to 2.7 or 3.x.
> 
> We can have the FQDNs additionally to http://docs.python.org and have
> them as mnemonic for the correct Python 2.x or 3.x docs. It's easy to
> create an Apache rewrite rule that redirects the user to the proper
> documents.
> 
>  RewriteCond %{HTTP_HOST} =docs3.python.org [NC]
>    RewriteRule ^/(.*) http://docs.python.org/release/3.3.0/$1 [R=301,L]
> 
> Yury, I'm not arguing against your JS UI -- I actually like it. I like
> to have both.

Thanks ;)

The thing about 'doc2' & 'doc3' urls I don't like is that sooner or later
users will use python 3.  There is no future for python 2.  That's why
I think that it's better to have just one main doc destination that
everybody knows, uses, and posts links to.  Just my 2 cents.

-
Yury



More information about the Python-ideas mailing list