[Distutils] "Python Packaging User Guide" has moved

Nick Coghlan ncoghlan at gmail.com
Wed Jan 15 10:30:55 CET 2014

On 15 Jan 2014 17:15, "Marcus Smith" <qwcode at gmail.com> wrote:
> Fyi, the "Python Packaging User Guide" has moved from bitbucket to github.
> The new project home is here:
> and the built site is still here:

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

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


> Marcus
> _______________________________________________
> Distutils-SIG maillist  -  Distutils-SIG at python.org
> https://mail.python.org/mailman/listinfo/distutils-sig
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/distutils-sig/attachments/20140115/3dca15d0/attachment.html>

More information about the Distutils-SIG mailing list