On 15 Jan 2014 17:15, "Marcus Smith" <qwcode@gmail.com> wrote:
>
> Fyi, the "Python Packaging User Guide" has moved from bitbucket to github.
>
> The new project home is here:  https://github.com/pypa/python-packaging-user-guide
> and the built site is still here: https://python-packaging-user-guide.readthedocs.org/en/latest/

Guess I better make a new clone :)

> 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.
>
> 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"

I would include docs.python.org 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.

> 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:  https://github.com/pypa/python-packaging-user-guide/issues
>
> My goal is to have something that's sufficient for a public announcement by PyCon.

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.

Cheers,
Nick.

>
> Marcus
>
> _______________________________________________
> Distutils-SIG maillist  -  Distutils-SIG@python.org
> https://mail.python.org/mailman/listinfo/distutils-sig
>