[Distutils] Deleting legacy contents from core install guide?

[Chris Jerdonek]

On Sun, Feb 23, 2014 at 1:48 PM, Marcus Smith <qwcode at 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