[Twisted-Python] Documentation overviews

Cary Hull cary.hull at gmail.com
Mon Apr 6 16:38:21 EDT 2009


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.

On Sat, Apr 4, 2009 at 9:38 AM, Dave Britton <dave at davebritton.com> wrote:

>  Twisted masters,
> As a twisted newbie, who still doesn't really feel like I get it, but is
> really drawn to it anyway, my humble advice is to teach how to navigate the
> use of the libraries,. especially with respect to how data is passed from
> one process to another, and how to understand the process flow, and how to
> integrate your own code for your application into the library correctly. It
> seems like there is an expected but unstated right approach or style that
> will work best and most easily... the tao of twisted so to speak... but what
> is this path?
>    Being old I still think in terms of sequences, conditionals and
> iterations, so it took a while to get that if I wanted a sequence of
> operations to happen as an asynchronous event (a Deferred) that went off on
> its own for a while, (and when it returns, whatever was going on wherever it
> was called from is long gone, like the deferred was some spaceship returning
> from a long near-lightspeed journey!) I had to construct that sequence as
> a string of callbacks, each attached to the previous, and to get any
> conditional or iterative activity within that sequence I had to figure out
> how to pass arguments that would provide enough information to the next
> callback. That has been extra tricky for me in the context of how to
> correctly use the library of classes available, especially how and/or when
> to extend or subclass them. In part this is because although I have used
> python for a number of years, I have never pushed the envelope in terms of
> power programming techniques. Thus, it would be helpful also if there was a
> subsection of the documentation that discussed how advanced python
> techniques (eg Factories) are used (more about python than twisted, per se,
> but essential to understanding and using twisted). The Protocol class and
> how to use it viz the Factory a Protocol goes with is especially confusing
> to me, for example, yet this is essential in twisted.
>    So I admire you guys tremendously and appreciate your work. I hope
> someday I grok it enough to be able to contribute to the documentation in
> some way.
> -Dave Britton
>
> ----- Original Message -----
> *From:* Cary Hull <cary.hull at gmail.com>
> *To:* Twisted general discussion <twisted-python at twistedmatrix.com>
> *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 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.
>
> ---
>
> Overviews
>
> #   The basics of event driven applications (beginner)
>
> #   No hand holding, just the facts (advanced, already familiar with
> concepts involved)
>
> #   Testing Twisted applications
>
> #   Driving processes (interactively or otherwise)
>
> #   Custom protocols
>
> #   When it makes sense to use threads
>
> #   Persisting application data (Would cover various options including
> Axiom)
>
> #   Task scheduling (Would cover various options including Axiom)
>
> #   Web clients
>
> #   Web applications using just Twisted
>
> #   Web applications using WSGI (Maybe show how to run Django)
>
> #   Mail clients
>
> #   Mail servers
>
> #   SSH clients
>
> #   SSH servers
>
> #   XMPP (Jabber) clients
>
> #   XMPP (Jabber) servers
>
> #   Multiple servers in a single application
>
> #   GUI applications (non web)
>
> #   Networked video games
>
> ------------------------------
>
> _______________________________________________
> Twisted-Python mailing list
> Twisted-Python at twistedmatrix.com
> http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python
>
>
> _______________________________________________
> Twisted-Python mailing list
> Twisted-Python at twistedmatrix.com
> http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python
>
>


-- 
01100011 01100001 01110010 01111001
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://twistedmatrix.com/pipermail/twisted-python/attachments/20090406/de572cb2/attachment.htm 


More information about the Twisted-Python mailing list