[Python-Dev] www.python.org/doc and docs.python.org hotfixed

[Georg Brandl]

Adam Olsen schrieb:
> On Thu, Oct 2, 2008 at 6:17 AM, Georg Brandl <g.brandl at gmx.net> wrote:
>> Doug Hellmann schrieb:
>>
>>>> Not a single one, no. The URLs *all* changed. There is not a single
>>>> one that's the same. We may be able to do a single rewrite rule for
>>>> most of the module-*.html URLs, but everything else -- and there is
>>>> quite a lot of 'else' in the 2.5-and-earlier docs -- needs a better
>>>> mapping. Feel free to send me that mapping :-)
>>>
>>> Perhaps it has already been suggested and rejected for some reason, but
>>> we could include the major/minor version numbers in the URLs.  That
>>> would make it easier to rewrite old URLs, and I assume there will be 2.x
>>> and 3.x documentation available online for some period of time?
>>>
>>> docs.python.org/lib/* could redirect to docs.python.org/2.5/lib/*
>>
>> That would be possible, but not sensible IMO -- it doesn't make people
>> update their links, instead keeps links to outdated documentation.
>>
>>> docs.pyhton.org/ (note no *) could redirect to docs.python.org/2.6/ and
>>> include a link to docs.python.org/3.0/
>>
>> We already have archived versioned docs at http://www.python.org/doc/X.Y.
> 
> Why not use versioned URLs, but with a  link at the top of old pages
> saying they're outdated, linking to the new version.  Either way they
> should update their links, but this way you don't shoot them in the
> foot to do it.

If linking to the new version could be done easily, we could as well directly
redirect. The problem is that having that mapping in the first place is hard.

Georg

-- 
Thus spake the Lord: Thou shalt indent with four spaces. No more, no less.
Four shall be the number of spaces thou shalt indent, and the number of thy
indenting shall be four. Eight shalt thou not indent, nor either indent thou
two, excepting that thou then proceed to four. Tabs are right out.