Re: [Python-Dev] Beta version of the new devguide

2011-01-28 Thread Brett Cannon
On Thu, Jan 27, 2011 at 22:52, Eli Bendersky wrote: > On Sun, Jan 23, 2011 at 03:08, Brett Cannon wrote: >> http://docs.python.org/devguide/ >> >> If you are a core developer and have a correction you want to make you >> can simply check out the devguide yourself (link is in the Resources >> sect

Re: [Python-Dev] Beta version of the new devguide

2011-01-27 Thread Eli Bendersky
On Sun, Jan 23, 2011 at 03:08, Brett Cannon wrote: > http://docs.python.org/devguide/ > > If you are a core developer and have a correction you want to make you > can simply check out the devguide yourself (link is in the Resources > section of the devguide) and make the corrections yourself. Othe

Re: [Python-Dev] Beta version of the new devguide

2011-01-24 Thread Brett Cannon
On Mon, Jan 24, 2011 at 07:46, Antoine Pitrou wrote: > On Sat, 22 Jan 2011 17:08:00 -0800 > Brett Cannon wrote: >> >> Two, what should the final URL be? Georg picked the current one and I >> am happy with it. > > Ditto for me. > >> Three, where should it be linked from? docs.python.org homepage?

Re: [Python-Dev] Beta version of the new devguide

2011-01-24 Thread Brett Cannon
On Mon, Jan 24, 2011 at 07:33, Nick Coghlan wrote: > On Mon, Jan 24, 2011 at 9:29 PM, Antoine Pitrou wrote: >> On Mon, 24 Jan 2011 20:33:07 +1000 >> Nick Coghlan wrote: >>> On Mon, Jan 24, 2011 at 6:22 AM, Brett Cannon wrote: >>> >> In "Getting Set Up" it describes how to build a pydebug build.

Re: [Python-Dev] Beta version of the new devguide

2011-01-24 Thread Antoine Pitrou
On Sat, 22 Jan 2011 17:08:00 -0800 Brett Cannon wrote: > > Two, what should the final URL be? Georg picked the current one and I > am happy with it. Ditto for me. > Three, where should it be linked from? docs.python.org homepage? > Four, what to do with www.python.org/dev/? Redirect for all the

Re: [Python-Dev] Beta version of the new devguide

2011-01-24 Thread Nick Coghlan
On Mon, Jan 24, 2011 at 9:29 PM, Antoine Pitrou wrote: > On Mon, 24 Jan 2011 20:33:07 +1000 > Nick Coghlan wrote: >> On Mon, Jan 24, 2011 at 6:22 AM, Brett Cannon wrote: >> >> In "Getting Set Up" it describes how to build a pydebug build. Is that >> >> really necessary for those who plan only to

Re: [Python-Dev] Beta version of the new devguide

2011-01-24 Thread Antoine Pitrou
On Mon, 24 Jan 2011 20:33:07 +1000 Nick Coghlan wrote: > On Mon, Jan 24, 2011 at 6:22 AM, Brett Cannon wrote: > >> In "Getting Set Up" it describes how to build a pydebug build. Is that > >> really necessary for those who plan only to contribute by working on > >> pure Python code? > >> > > > > Y

Re: [Python-Dev] Beta version of the new devguide

2011-01-24 Thread Mark Summerfield
Hi Brett, On Sat, 22 Jan 2011 17:08:00 -0800 Brett Cannon wrote: > http://docs.python.org/devguide/ Personally, I found the first paragraph of "Contributing" a bit off-putting. How about replacing: People who wish to contribute to Python must read the following documents in the order p

Re: [Python-Dev] Beta version of the new devguide

2011-01-24 Thread Nick Coghlan
On Mon, Jan 24, 2011 at 6:22 AM, Brett Cannon wrote: >> In "Getting Set Up" it describes how to build a pydebug build. Is that >> really necessary for those who plan only to contribute by working on >> pure Python code? >> > > Yes, there is actually a laundry list of reasons even people only > wor

Re: [Python-Dev] Beta version of the new devguide

2011-01-23 Thread Michael Foord
On 23/01/2011 20:22, Brett Cannon wrote: [snip...] I had a quick skim over the rest and got the feeling that no clear distinction is made between C and Python work. Personally, I feel that more of a distinction should be made since not everyone will be confident or interested in C. (And maybe mo

Re: [Python-Dev] Beta version of the new devguide

2011-01-23 Thread Brett Cannon
On Sat, Jan 22, 2011 at 23:56, Mark Summerfield wrote: > Hi Brett, > > On Sat, 22 Jan 2011 17:08:00 -0800 > Brett Cannon wrote: >> http://docs.python.org/devguide/ > > Personally, I found the first paragraph of "Contributing" a bit > off-putting. > > How about replacing: > >    People who wish to

Re: [Python-Dev] Beta version of the new devguide

2011-01-22 Thread Brett Cannon
And I forgot to mention I also plan to edit the help text on the various fields on the issue tracker to point to the triaging doc. On Sat, Jan 22, 2011 at 17:08, Brett Cannon wrote: > http://docs.python.org/devguide/ > > If you are a core developer and have a correction you want to make you > can

[Python-Dev] Beta version of the new devguide

2011-01-22 Thread Brett Cannon
http://docs.python.org/devguide/ If you are a core developer and have a correction you want to make you can simply check out the devguide yourself (link is in the Resources section of the devguide) and make the corrections yourself. Otherwise reply here (you can email me directly but I already hav