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

[Adam Olsen]

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.

Breaking old links should be avoided if at all possible.


-- 
Adam Olsen, aka Rhamphoryncus