<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">On 14 July 2013 21:09, Paul Moore <span dir="ltr"><<a href="mailto:p.f.moore@gmail.com" target="_blank">p.f.moore@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<div dir="ltr">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.<div>

<br></div><div>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 <a href="http://www.pip-installer.org" target="_blank">www.pip-installer.org</a> for the complete documentation" reference?</div>
</div></blockquote><div><br></div><div>This is the hole <a href="https://python-packaging-user-guide.readthedocs.org/en/latest/">https://python-packaging-user-guide.readthedocs.org/en/latest/</a> 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.<br>
<br></div><div>I spent some time at PyCon AU talking to Matthew Iverson (<a href="https://bitbucket.org/Ivoz/python-packaging-user-guide">https://bitbucket.org/Ivoz/python-packaging-user-guide</a>) who <br></div><div><br>
</div><div>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. <br></div><div><br></div><div>Cheers,<br>
Nick.<br></div></div><br>-- <br>Nick Coghlan   |   <a href="mailto:ncoghlan@gmail.com">ncoghlan@gmail.com</a>   |   Brisbane, Australia
</div></div>