[Distutils] Another conversation starter - pip documentation in the Python docs

Nick Coghlan ncoghlan at gmail.com
Sun Jul 14 13:42:32 CEST 2013

On 14 July 2013 21:09, Paul Moore <p.f.moore at gmail.com> wrote:

> I don't think there is any doubt that we need to document to at least some
> extent how to use pip, in the Python documentation for 3.4. The obvious
> place is "Installing Python Modules" as a chapter to itself.
> What is less clear to me is how much to document - just basic "pip install
> XXX", or the whole pip command set, or somewhere in between? Should there
> be some type of "refer to www.pip-installer.org for the complete
> documentation" reference?

This is the hole
https://python-packaging-user-guide.readthedocs.org/en/latest/ is supposed
to fill - once it's "ready" (i.e. things have stabilised sufficiently ,
then I'd like to replace the "Installing Python Modules" and "Distributing
Python Modules" sections for 2.7 and 3.3 with some *very* abbreviated quick
start guides that then reference that site. The 3.3 changes would then
carry over into 3.4.

I spent some time at PyCon AU talking to Matthew Iverson (
https://bitbucket.org/Ivoz/python-packaging-user-guide) who

I believe Marcus was hoping to get back to that after pip 1.4 was out the
door, but anyone on the PyPA list on BitBucket actually has full access to
accept pull requests, etc.


Nick Coghlan   |   ncoghlan at gmail.com   |   Brisbane, Australia
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/distutils-sig/attachments/20130714/e7aa1027/attachment.html>

More information about the Distutils-SIG mailing list