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@python
components: Documentation
messages: 257529
nosy: docs@python, ncoghlan
priority: normal
severity: normal
stage: needs patch
status: open
title: Guide users to the newer package install instructions
type: enhancement

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue26014>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to