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

Marcus Smith qwcode at gmail.com
Sun Jul 14 19:02:20 CEST 2013


> Hmm, OK. I've no problem with that (although I do find the packaging guide
> pretty hard to get into for an end user who only wants to *use* packages,
> not *create* them
>

there's a section marked "Installation Tutorial".  Someone wanting to
install packages should be able to get into that, once it actually has
content  : )


> I think we should explain *in the core documentation*
>
How about if I provide a new (short) document called something like "Python
> package management"
>

IMO, we should put the energy into one comprehensive document (the new user
guide) and link out to it, not duplicate effort into the core docs.
The "Installing Python Modules"/"Distributing Python Modules" documents
should be integrated into the new User Guide.
It will be confusing and anti-zen for a user to come upon those documents
and have to reconcile it with the user guide

Marcus
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/distutils-sig/attachments/20130714/f6044373/attachment.html>


More information about the Distutils-SIG mailing list