On Sun, Feb 23, 2014 at 1:48 PM, Marcus Smith <qwcode@gmail.com> wrote:
However, after thinking a little more on the challenge, I believe the lower level legacy content should fit right in as a new subsection in the distutils docs at http://docs.python.org/3/distutils/index.html.
There's 3 things right now:
1. http://docs.python.org/3/distutils/index.html ("Installing Python Modules") 2. http://docs.python.org/3/install/index.html ("Distributing Python Modules") 3. http://docs.python.org/3/library/distutils.html ("28.15. distutils")
I was thinking that #1 and #2 should disappear (or just provide a link to the PUG). I don't think you should bother to recreate any more guides in the python.org docs. The valuable "reference" content in #1 and #2 should be refactored into #3.
To be explicit about one aspect of this process, I think content we want documented going forward should only be removed once the information has been added in its replacement form. For example, for stuff moving to PUG, I don't think we should remove a section from "Distributing Python Modules" if the information we want there is not yet in PUG. A lot of PUG is still in a skeletal state. By the way, I noticed that PUG's "Installation & Packaging Tutorial" [1] is one section. Shouldn't those be separate tutorials? IIRC that information was in separate sections before (one for installing and one for packaging). --Chris [1] http://python-packaging-user-guide.readthedocs.org/en/latest/tutorial.html