Re: [Distutils] Deleting legacy contents from core install guide?

2014-02-23 Thread Marcus Smith
> > > Yeah, that history still shows. The first section called "Install the > Tools" is only about installing the tools needed for installation. > Well, for packaging, minimally you'll need setuptools, and we recommend using get-pip or pip to install setuptools. And if you're going to work in "de

Re: [Distutils] Deleting legacy contents from core install guide?

2014-02-23 Thread Chris Jerdonek
On Sun, Feb 23, 2014 at 2:50 PM, Marcus Smith wrote: >> >> 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). >

Re: [Distutils] Deleting legacy contents from core install guide?

2014-02-23 Thread Marcus Smith
> > > > 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

Re: [Distutils] Deleting legacy contents from core install guide?

2014-02-23 Thread Chris Jerdonek
On Sun, Feb 23, 2014 at 1:48 PM, Marcus Smith 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 r

Re: [Distutils] Deleting legacy contents from core install guide?

2014-02-23 Thread Marcus Smith
> > > > I'm willing to work on a patch for this, if you agree. > > I do like the idea of moving most of the distutils docs into the distutils > module reference. > > If you were willing to handle that task, that would be brilliant - I'd > then focus on writing *new* content > ok, I'll see what I c

Re: [Distutils] Deleting legacy contents from core install guide?

2014-02-23 Thread Nick Coghlan
On 24 Feb 2014 07:48, "Marcus Smith" 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 n

Re: [Distutils] Deleting legacy contents from core install guide?

2014-02-23 Thread Marcus Smith
> > > 1. http://docs.python.org/3/distutils/index.html("Installing Python > Modules") > 2. http://docs.python.org/3/install/index.html ("Distributing Python > Modules") > woops, I reversed the links for these. ___ Distutils-SIG maillist - Distutil

Re: [Distutils] Deleting legacy contents from core install guide?

2014-02-23 Thread Marcus Smith
> > > 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

Re: [Distutils] Deleting legacy contents from core install guide?

2014-02-23 Thread Nick Coghlan
On 23 February 2014 22:00, Paul Moore wrote: > On 23 February 2014 11:43, Nick Coghlan wrote: >> With that content gone from the end user installation guide in 3.4+, >> it can become just a very, very simple introduction to the core pip >> commands, and then a reference out to the packaging user

Re: [Distutils] Deleting legacy contents from core install guide?

2014-02-23 Thread Paul Moore
On 23 February 2014 11:43, Nick Coghlan wrote: > With that content gone from the end user installation guide in 3.4+, > it can become just a very, very simple introduction to the core pip > commands, and then a reference out to the packaging user guide for > more info. > > Thoughts? Are "setup.py

[Distutils] Deleting legacy contents from core install guide?

2014-02-23 Thread Nick Coghlan
I finally started working on the docs.python.org updates for PEP 453 tonight, and I'm just not seeing much salvageable information in http://docs.python.org/3/install/index.html. While it was a big step forward back in 1998, it seems to me that it has simply been left unmaintained for too long, an