On 15 Jan 2014 17:15, "Marcus Smith" <qwc...@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 >
_______________________________________________ Distutils-SIG maillist - Distutils-SIG@python.org https://mail.python.org/mailman/listinfo/distutils-sig
