[docs] [issue24124] Two versions of instructions for installing Python modules

[Skip Montanaro]

New submission from Skip Montanaro:

I was hunting around the current website for notes on installing Python. Couldn't find any (BTW), so I looked in the Python source. Imagine my surprise to find two apparently overlapping files describing how to build Python modules:

./Doc/install/index.rst
./Doc/installing/index.rst

The former is marked "Legacy version." The latter seems to cover mostly installation of third-party modules using tools like pip. The former covers distutils.  Oddly enough, the "legacy" version seems to have been updated more recently than the presumably current version. Do we really need to keep both versions around at this point? Should they be merged into a single document? If they are to both be retained, should the legacy version be marked as such more clearly and refer readers to the pip/pyvenv/virtualenv version?

----------
assignee: docs at python
components: Documentation
messages: 242555
nosy: docs at python, skip.montanaro
priority: normal
severity: normal
status: open
title: Two versions of instructions for installing Python modules
versions: Python 3.5

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue24124>
_______________________________________