[docs] [issue26014] Guide users to the newer package install instructions

Nick Coghlan report at bugs.python.org
Tue Jan 5 08:04:26 EST 2016

New submission from Nick Coghlan:

The up to date module installation docs are at:

* https://docs.python.org/2/installing/index.html
* https://docs.python.org/3/installing/index.html

However, legacy deep links still resolve to the old docs:

* https://docs.python.org/2/install/index.html
* https://docs.python.org/3/install/index.html

Those link out to packaging.python.org, the link is buried in a longish note, rather than being highlighted as a more obvious See Also link.

The top level landing page in the Python 2.7 docs also still links to the legacy docs rather than the new ones, and the "(Legacy)" notation hasn't been appended to the headings on the legacy docs the way it has in 3.x.

There's a few long hanging fruit for cleanup here:

* add See Also links to the modern docs from the legacy docs
* append the (Legacy) suffix in the 2.x docs
* fix the 2.x top level docs page to link to the new docs rather than the legacy ones
* link to the legacy docs from the distutils package docs in 2.7 (as has already been done in 3.x)

assignee: docs at python
components: Documentation
messages: 257529
nosy: docs at python, ncoghlan
priority: normal
severity: normal
stage: needs patch
status: open
title: Guide users to the newer package install instructions
type: enhancement

Python tracker <report at bugs.python.org>

More information about the docs mailing list