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)

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

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

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.