<p dir="ltr"><br>
On 15 Jan 2014 17:15, "Marcus Smith" <<a href="mailto:qwcode@gmail.com">qwcode@gmail.com</a>> wrote:<br>
><br>
> Fyi, the "Python Packaging User Guide" has moved from bitbucket to github.<br>
><br>
> The new project home is here:  <a href="https://github.com/pypa/python-packaging-user-guide">https://github.com/pypa/python-packaging-user-guide</a><br>
> and the built site is still here: <a href="https://python-packaging-user-guide.readthedocs.org/en/latest/">https://python-packaging-user-guide.readthedocs.org/en/latest/</a></p>
<p dir="ltr">Guess I better make a new clone :)</p>
<p dir="ltr">> For those who are interested in helping, a quick survey of the text will show many sections marked up with "FIXME" comments.   Although general editing is helpful, I think we mostly need "packaging experts" at this point who are willing to invest the time in filling out and correcting the sections they feel strong on.<br>

><br>
> As stated in the README, "The guide is part of a larger effort to improve all of the packaging and installation docs, including pip, setuptools, virtualenv, and wheel. Ultimately, users need more than a "guide" to feel confident about the current tools. They need complete, accurate and inter-consistent documentation across all the projects"</p>

<p dir="ltr">I would include <a href="http://docs.python.org">docs.python.org</a> in that list. I've already added links from the relevant pages to the user's guide (as even in its current incomplete state it is a better end user resource than the stdlib docs), but ultimately we need to cull the current outdated information from the stdlib docs and actively promote the development of cross-version compatible packages.</p>

<p dir="ltr">> As such, a lot of my effort will be going into improving and normalizing the pip/setuptools/virtualenv/wheel docs directly so the Packaging User Guide doesn't have to do all the work on top of those docs.  I have issues open for each of the four projects:  <a href="https://github.com/pypa/python-packaging-user-guide/issues">https://github.com/pypa/python-packaging-user-guide/issues</a><br>

><br>
> My goal is to have something that's sufficient for a public announcement by PyCon.</p>
<p dir="ltr">There's also the Python 3.4 release in March - I haven't decided yet if the new install docs will point directly at pip's docs or at the user guide, but I'm currently leaning towards the latter.</p>

<p dir="ltr">Cheers,<br>
Nick.</p>
<p dir="ltr">><br>
> Marcus<br>
><br>
> _______________________________________________<br>
> Distutils-SIG maillist  -  <a href="mailto:Distutils-SIG@python.org">Distutils-SIG@python.org</a><br>
> <a href="https://mail.python.org/mailman/listinfo/distutils-sig">https://mail.python.org/mailman/listinfo/distutils-sig</a><br>
><br>
</p>