[Twisted-Python] Refactoring Documentation

2011-01-19 Thread Tom Davis
I've been using (and threatening to work on) Twisted for a few years now. It seems like every time I get back into it, I need to dig up old code or Google queries just to get started. Yesterday, Jean-Paul introduced me to the trial-tutorial branch

Re: [Twisted-Python] Refactoring Documentation

2011-01-20 Thread Tom Davis
Wow! Okay, so, not being really familiar with the list etiquette combined with the fact that the topic has digressed a bit, I hope you'll forgive the non-inline reply here. I want to hit the main points of what everybody said / asked, but let it be known that I read all of it! How can we combine t

Re: [Twisted-Python] Refactoring Documentation

2011-01-21 Thread Tom Davis
On Fri, Jan 21, 2011 at 5:35 PM, Glyph Lefkowitz wrote: > > On Jan 21, 2011, at 8:29 AM, exar...@twistedmatrix.com wrote: > > I don't think it makes sense to put anything on Launchpad for now. > Eventually it needs to go into the canonical Twisted repository, but if > it's easier to leave it in Gi

Re: [Twisted-Python] Refactoring Documentation

2011-01-22 Thread Tom Davis
On Fri, Jan 21, 2011 at 10:00 PM, Glyph Lefkowitz wrote: > On Jan 20, 2011, at 11:20 PM, Tom Davis wrote: > > I definitely agree that resolving the low-hanging fruit first is a good > idea. For finishing "docs branch X" to make sense, my personal belief is > that X

[Twisted-Python] Fingering Finger

2011-01-22 Thread Tom Davis
In this thread, I hope to find a resolution to the issue of the Finger tutorial and efforts to sufficiently improve it or remove it. In the course of reviewing documentation-related tickets, I stumbled upon #1148 (http://twistedmatrix.com/trac/ticket/1148). Therein, Glyph first(?) put down a lot o

Re: [Twisted-Python] Weekly Bug Summary

2011-01-22 Thread Tom Davis
> > Mean open ticket age: 1032 days Mean time between ticket creation and ticket resolution: 238 days Mean time spent in review: 83 days Wow. Adding "reduce these by at least one order of magnitude" to my todo list. Gotta have goals! On Sun, Jan 23, 2011 at 12:05 AM, wrote: > Bug summary >

Re: [Twisted-Python] Refactoring Documentation

2011-01-22 Thread Tom Davis
On Sat, Jan 22, 2011 at 10:02 PM, Glyph Lefkowitz wrote: > > On Jan 22, 2011, at 3:18 PM, Tom Davis wrote: > > On Fri, Jan 21, 2011 at 10:00 PM, Glyph Lefkowitz > wrote: > >> On Jan 20, 2011, at 11:20 PM, Tom Davis wrote: >> >> If branches that are ou

Re: [Twisted-Python] HTTPClient handling LF only servers

2011-01-25 Thread Tom Davis
On Tue, Jan 25, 2011 at 2:23 PM, Kevin Horn wrote: > On Tue, Jan 25, 2011 at 11:54 AM, Jason J. W. Williams < > jasonjwwilli...@gmail.com> wrote: > >> Hi Y'all, >> >> > Howdy, Jason! > > > >> Certain servers (notably Hacker News) break HTTPClient because they use LF >> instead of CRLF to terminat

Re: [Twisted-Python] HTTPClient handling LF only servers

2011-01-26 Thread Tom Davis
On Wed, Jan 26, 2011 at 1:39 PM, wrote: > On 06:28 pm, gl...@twistedmatrix.com wrote: > > > >On Jan 25, 2011, at 6:09 PM, Kevin Horn wrote: > >>Well, I can update the summary, but not the description, which is the > >>really bad part. > > > >The description _is_ mutable, just only by certain magi

Re: [Twisted-Python] Using SerialPort with t.a.s.Application

2011-01-28 Thread Tom Davis
On Fri, Jan 28, 2011 at 10:38 AM, Kevin Horn wrote: > > > On Fri, Jan 28, 2011 at 7:25 AM, Itamar Turner-Trauring < > ita...@itamarst.org> wrote: > >> >> A service is supposed >> to be something you can start and stop, and encapsulates a >> self-contained piece of business logic. >> >> -Itamar >>

[Twisted-Python] Task-based documentation started

2011-01-31 Thread Tom Davis
I have the beginnings of some task-based documentation available in twisted-docs (https://github.com/tdavis/twisted-docs) now. You can find the built version in the usual place (http://docs.recursivedream.com/twisted/) -- just remember to bust the cache. I chose serving web content as a starting p

Re: [Twisted-Python] Task-based documentation started

2011-01-31 Thread Tom Davis
On Mon, Jan 31, 2011 at 5:22 PM, Glyph Lefkowitz wrote: > > On Jan 31, 2011, at 11:41 AM, Tom Davis wrote: > > Thoughts? > > > I'll have to write more later, but maybe you should read *all* of the > existing twisted.web documentation first? I am sorry to say it,

Re: [Twisted-Python] Task-based documentation started

2011-02-01 Thread Tom Davis
On Tue, Feb 1, 2011 at 3:44 AM, Albert Brandl wrote: > On Mon, Jan 31, 2011 at 02:41:38PM -0500, Tom Davis wrote: > > Thoughts? > > I think that the overview in the first two sections is very good. It > made me curious to learn more. > > The "breadcrumbs&quo

Re: [Twisted-Python] Task-based documentation started

2011-02-01 Thread Tom Davis
On Mon, Jan 31, 2011 at 6:19 PM, wrote: > On 10:39 pm, t...@recursivedream.com wrote: > > > >Take < > >http://twistedmatrix.com/documents/10.2.0/web/howto/web-in-60/static- > >content.html > >>: > > > >Tell me the one command I need to serve a directory, *then* show me the > >code > >that one com

Re: [Twisted-Python] Task-based documentation started

2011-02-01 Thread Tom Davis
On Tue, Feb 1, 2011 at 12:58 PM, Glyph Lefkowitz wrote: > > On Jan 31, 2011, at 11:41 AM, Tom Davis wrote: > > Thoughts? > > > Priority #1 for most people who are enthusiastic about documentation is to > come in and write a ton of additional documentation. But this is a

Re: [Twisted-Python] Task-based documentation started

2011-02-06 Thread Tom Davis
On Tue, Feb 1, 2011 at 5:15 PM, Glyph Lefkowitz wrote: > > On Feb 1, 2011, at 10:53 AM, Tom Davis wrote: > > On Tue, Feb 1, 2011 at 12:58 PM, Glyph Lefkowitz > wrote: > >> >> On Jan 31, 2011, at 11:41 AM, Tom Davis wrote: >> >> Thoughts? >> >&g

Re: [Twisted-Python] Change to ticket workflow

2011-02-06 Thread Tom Davis
On Sun, Feb 6, 2011 at 5:12 PM, wrote: > Hi all, > > Last weekend I changed the default owner for all components in the issue > tracker to be nobody. I also installed the "DefaultCC" plugin which > lets us configure a list of users to be added to the cc list of tickets > on a per-component basis

Re: [Twisted-Python] Boston Mini-Sprint: February Edition

2011-02-06 Thread Tom Davis
On Feb 6, 2011, at 9:05 PM, Tenth wrote: > We'll be holding another Boston-area Twisted Mini-Sprint on Sunday, February > 13th at my place in Somerville, MA... I've sent out invitations to the > attendees from last time, plus a few other people who've expressed interest, > but if you weren't i

Re: [Twisted-Python] twisted can't find internet module

2011-02-10 Thread Tom Davis
On Thu, Feb 10, 2011 at 1:14 PM, Glyph Lefkowitz wrote: > On Feb 10, 2011, at 8:08 AM, Stephen Thorne wrote: > > I am also very curious about the nature of the "problem horse", as > > google translate suggests the first response is about. :-) > > > I did not use google translate, but I was wonderi

Re: [Twisted-Python] PyCon 2011 Twisted Sprint

2011-03-02 Thread Tom Davis
On Wed, Mar 2, 2011 at 11:45 PM, Glyph Lefkowitz wrote: > > On Mar 2, 2011, at 11:28 PM, exar...@twistedmatrix.com wrote: > > > On 8 Feb, 04:24 pm, exar...@twistedmatrix.com wrote: > >> Hello all, > >> > >> Once again, we will be sprinting at PyCon. I've just added Twisted to > >>

Re: [Twisted-Python] PyCon 2011 Twisted Sprint

2011-03-03 Thread Tom Davis
On Thu, Mar 3, 2011 at 1:18 AM, Glyph Lefkowitz wrote: > > On Mar 3, 2011, at 12:21 AM, Tom Davis wrote: > > On Wed, Mar 2, 2011 at 11:45 PM, Glyph Lefkowitz > wrote: > >> >> On Mar 2, 2011, at 11:28 PM, exar...@twistedmatrix.com wrote: >> >> > On 8 F

Re: [Twisted-Python] Announcing Twisted 11.0.0pre1!

2011-03-22 Thread Tom Davis
On Tue, Mar 22, 2011 at 8:17 PM, Jessica McKellar < jessica.mckel...@gmail.com> wrote: > Intrepid Twisted developers and users: from Cambridge, Massachusetts I > am pleased to announce the arrival of Twisted 11.0.0 pre-release 1. > > Tarballs for the pre-release are available at: > http://twisted

Re: [Twisted-Python] prerelease preview predocumentation

2011-03-28 Thread Tom Davis
On Sun, Mar 27, 2011 at 9:57 PM, Glyph Lefkowitz wrote: > > On Mar 23, 2011, at 9:34 PM, Glyph Lefkowitz wrote: > > > > > Anyone have comments about this? With all the recent excitement about the > docs, I thought there would be a much mo

Re: [Twisted-Python] Information on new endpoints API?

2011-06-13 Thread Tom Davis
reference). I have a few ideas that I think >> would help newcomers find their away around much easier (and be less >> scared of twisteD). The ideas are mostly organisational, the material >> is there, if one knows what to look for. Should I create new tickets or >> mail

Re: [Twisted-Python] SURVEY: Have you submitted a patch to Twisted and it never got in?

2011-07-01 Thread Tom Davis
On Jul 1, 2011, at 1:41 PM, Glyph Lefkowitz wrote: > > On Jul 1, 2011, at 1:08 PM, chris wrote: > >> doing continuous development based on tools like >> svn and trac is really painful and it's really difficult to motivate >> yourself to work on a once rejected ticket > > Can you be more spec

Re: [Twisted-Python] Website visual improvements

2011-11-06 Thread Tom Davis
On Nov 6, 2011, at 12:51 PM, Jonathan Jacobs wrote: > Hello, > > I recently volunteered to make some visual improvements to the Twisted Trac > website. I received a lot of good feedback and suggestions from the IRC > channel, most of which I took to heart and fine-tuned the changes. I think

Re: [Twisted-Python] Twisted Project Jobs Volunteer

2011-11-09 Thread Tom Davis
On 11/09/2011 07:49 AM, Tim Allen wrote: > On Wed, Nov 09, 2011 at 12:50:23AM -0800, Glyph Lefkowitz wrote: >> On Nov 8, 2011, at 7:39 PM, Tim Allen wrote: >>> As far as I know (having written most of the documentation in the linked >>> wiki page, and from a brief skim through the git-svn manpage)