[issue26014] Guide users to the newer package install instructions

[Ned Deily]

Ned Deily added the comment:

Thanks, Susan, for your suggested patch.  I expanded on it to address all of 
the issues Nick brought up and then some, such as also updating to the changed 
setuptools doc link.  Pushed for release in 2.7.12, 3.5.2, and 3.6.0.

--
nosy: +ned.deily
resolution:  -> fixed
stage: needs patch -> resolved
status: open -> closed
versions: +Python 2.7, Python 3.5, Python 3.6

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue26014] Guide users to the newer package install instructions

[Roundup Robot]

Roundup Robot added the comment:

New changeset 71fc5b246f5b by Ned Deily in branch '2.7':
Issue #26014: Guide 2.7 users to the new packaging documentation:
https://hg.python.org/cpython/rev/71fc5b246f5b

New changeset f5fd646b265b by Ned Deily in branch '3.5':
Issue #26014: Update 3.x packaging documentation:
https://hg.python.org/cpython/rev/f5fd646b265b

New changeset 7583d65da2ad by Ned Deily in branch 'default':
Issue #26014: merge from 3.5
https://hg.python.org/cpython/rev/7583d65da2ad

--
nosy: +python-dev

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue26014] Guide users to the newer package install instructions

[Susan Sun]

Susan Sun added the comment:

Below two issues are fixed. 

* add See Also links to the modern docs from the legacy docs
* append the (Legacy) suffix in the 2.x docs

--
keywords: +patch
nosy: +Susan Sun, ezio.melotti
Added file: http://bugs.python.org/file42148/issue26014.diff

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue26014] Guide users to the newer package install instructions

[Nick Coghlan]

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 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com