[Twisted-Python] Documentation overviews
andrewfr_ice at yahoo.com
Fri Apr 3 13:57:12 EDT 2009
Date: Thu, 2 Apr 2009 09:05:27 -0700
From: Cary Hull <cary.hull at gmail.com>
Subject: [Twisted-Python] Documentation overviews
To: Twisted general discussion <twisted-python at twistedmatrix.com>
<3fce0ae70904020905l286b78acvb17f4f0d572d9680 at mail.gmail.com>
Content-Type: text/plain; charset="iso-8859-1"
>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 on a conversation >in the sprint room a few nights ago. Feedback would be greatly >appreciated.
Sadly I couldn't make it to PyCon 2009 this year. However I would add two things.
1) A Section on Control Flow.
In my PyCon 2008 talk, I tried to explain what the control flow of a Twisted programme was. I consider this lack of information a deficiency in the Fettig book (a book that helped me). I needed to understand control flow to solve my problem. I believe how control flow understand how Twisted can provide a form of non-preemptive multitasking without threads. It also explains how to structure a Twisted programme.
2) The Class Hierarchy
I believe a source of confusion is over how the classes are used. It would be good to have something like UML class diagrammes.
P.S - one of these days I have to fix the slides for "Adventures" and write the paper companion
More information about the Twisted-Python