Re: [Twisted-Python] Documentation by newcomers

2013-01-07 Thread exarkun
On 05:47 am, gl...@twistedmatrix.com wrote: > >To be fair I believe that it's not really feasible for someone new to >the topic to write anything useful entirely, or even mostly, by >themselves. But if they write something basically sensible but with >errors, it's easier for the experts to corr

[Twisted-Python] Documentation by newcomers (was Re: Using telnet or linereceiver protocol over ssh)

2013-01-06 Thread Glyph
On Jan 6, 2013, at 8:44 PM, Christopher Armstrong wrote: > On Sun, Jan 6, 2013 at 9:57 PM, wrote: > On 02:23 am, gl...@twistedmatrix.com wrote: > > >In a way, it is best to work on documentation when you don't yet fully > >understand, because if you fully understand you yourself don't need th

Re: [Twisted-Python] Documentation

2009-08-14 Thread Glyph Lefkowitz
On Wed, Aug 12, 2009 at 6:41 AM, John Aherne wrote: > I appreciate it it was a bit confused, but I wanted to get it out sooner > rather than later and just get the basic facts confirmed. > Yes, it's always good to share these early drafts. > So I will start putting my thoughts into better sha

Re: [Twisted-Python] Documentation

2009-08-12 Thread Jarrod Roberson
On Wed, Aug 12, 2009 at 6:41 AM, John Aherne wrote: > > > On Tue, Aug 11, 2009 at 10:03 PM, Glyph Lefkowitz > wrote: > >> On Mon, Aug 10, 2009 at 2:56 AM, John Aherne wrote: >> >>> Prompted by exarkun, I have put together some simple documentation for >>> beginners starting with Twisted. >>> >>

Re: [Twisted-Python] Documentation

2009-08-12 Thread John Aherne
On Tue, Aug 11, 2009 at 10:03 PM, Glyph Lefkowitz wrote: > On Mon, Aug 10, 2009 at 2:56 AM, John Aherne wrote: > >> Prompted by exarkun, I have put together some simple documentation for >> beginners starting with Twisted. >> > > Thanks for doing this. All documentation help is useful :). > > >>

Re: [Twisted-Python] Documentation

2009-08-11 Thread Glyph Lefkowitz
On Mon, Aug 10, 2009 at 2:56 AM, John Aherne wrote: > Prompted by exarkun, I have put together some simple documentation for > beginners starting with Twisted. > Thanks for doing this. All documentation help is useful :). > But before I spend more time on honing the document, I thought it wo

[Twisted-Python] Documentation

2009-08-10 Thread John Aherne
Prompted by exarkun, I have put together some simple documentation for beginners starting with Twisted. The points are made up of things I wish I had known from the start as a complete beginner. It still needs lots of work. The layout needs to change, there are duplications and the points need to

Re: [Twisted-Python] Documentation overviews

2009-04-12 Thread Cary Hull
I've been short on time lately so will post these in batches. Also it will give folks a chance to comment on the direction taken before I go too far. Each of these should be encapsulated in some overview prose. Also it's a good opportunity to link to external documentation such as related blog post

Re: [Twisted-Python] Documentation overviews

2009-04-06 Thread glyph
On 08:38 pm, cary.h...@gmail.com wrote: Thanks all for the excellent feedback so far. I will adapt it to a refinement on the proposal and update this thread sometime during the week. Thanks for your time. We're all looking forward to see what you can do with the documentation :-). ___

Re: [Twisted-Python] Documentation overviews

2009-04-06 Thread Cary Hull
te to the documentation in > some way. > -Dave Britton > > - Original Message - > *From:* Cary Hull > *To:* Twisted general discussion > *Sent:* Thursday, April 02, 2009 11:05 AM > *Subject:* [Twisted-Python] Documentation overviews > > Hi folks, > > One

Re: [Twisted-Python] Documentation overviews

2009-04-04 Thread Dave Britton
some way. -Dave Britton - Original Message - From: Cary Hull To: Twisted general discussion Sent: Thursday, April 02, 2009 11:05 AM Subject: [Twisted-Python] Documentation overviews Hi folks, One of the goals for the Pycon sprint was to develop user oriented overviews

Re: [Twisted-Python] Documentation overviews

2009-04-03 Thread glyph
On 2 Apr, 04:05 pm, cary.h...@gmail.com wrote: Hi folks, One of the goals for the Pycon sprint was to develop user oriented overviews for existing documentation. These would ideally guide users through everything they would need to read in order to accomplish a desired goal with Twisted. I

Re: [Twisted-Python] Documentation overviews

2009-04-03 Thread Andrew Francis
Message: 1 Date: Thu, 2 Apr 2009 09:05:27 -0700 From: Cary Hull Subject: [Twisted-Python] Documentation overviews To: Twisted general discussion Message-ID: <3fce0ae70904020905l286b78acvb17f4f0d572d9...@mail.gmail.com> Content-Type: text/plain; charset="iso-8859-1" Hi Ca

Re: [Twisted-Python] Documentation overviews

2009-04-02 Thread Michael P. Soulier
On 02/04/09 Cary Hull said: > # Web clients > > # Web applications using just Twisted > > # Web applications using WSGI (Maybe show how to run Django) # Web proxies, with and without authentication, with and without SSL Mike -- Michael P. Soulier "Any intelligent fool can make things b

[Twisted-Python] Documentation overviews

2009-04-02 Thread Cary Hull
Hi folks, One of the goals for the Pycon sprint was to develop user oriented overviews for existing documentation. These would ideally guide users through everything they would need to read in order to accomplish a desired goal with Twisted. I've formulated the following 'track' suggestions based