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.<br><br><div class="gmail_quote">On Sat, Apr 4, 2009 at 9:38 AM, Dave Britton <span dir="ltr"><<a href="mailto:dave@davebritton.com">dave@davebritton.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
<div bgcolor="#ffffff">
<div><font size="2" face="Arial">Twisted masters,</font></div>
<div><font size="2" face="Arial">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?</font></div>
<div><font size="2" face="Arial"> 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.</font></div>
<div><font size="2" face="Arial"> 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.</font></div>
<div><font size="2" face="Arial">-Dave Britton</font></div><font color="#888888">
</font><blockquote style="border-left: 2px solid rgb(0, 0, 0); padding-right: 0px; padding-left: 5px; margin-left: 5px; margin-right: 0px;"><div class="im">
<div style="font-family: arial; font-style: normal; font-variant: normal; font-weight: normal; font-size: 10pt; line-height: normal; font-size-adjust: none; font-stretch: normal;">----- Original Message ----- </div>
<div style="background: rgb(228, 228, 228) none repeat scroll 0% 0%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial; font-family: arial; font-style: normal; font-variant: normal; font-weight: normal; font-size: 10pt; line-height: normal; font-size-adjust: none; font-stretch: normal;">
<b>From:</b>
<a title="cary.hull@gmail.com" href="mailto:cary.hull@gmail.com" target="_blank">Cary Hull</a>
</div>
<div style="font-family: arial; font-style: normal; font-variant: normal; font-weight: normal; font-size: 10pt; line-height: normal; font-size-adjust: none; font-stretch: normal;"><b>To:</b> <a title="twisted-python@twistedmatrix.com" href="mailto:twisted-python@twistedmatrix.com" target="_blank">Twisted general discussion</a>
</div>
<div style="font-family: arial; font-style: normal; font-variant: normal; font-weight: normal; font-size: 10pt; line-height: normal; font-size-adjust: none; font-stretch: normal;"><b>Sent:</b> Thursday, April 02, 2009 11:05
AM</div>
<div style="font-family: arial; font-style: normal; font-variant: normal; font-weight: normal; font-size: 10pt; line-height: normal; font-size-adjust: none; font-stretch: normal;"><b>Subject:</b> [Twisted-Python] Documentation
overviews</div>
<div><font size="2" face="Arial"></font><font size="2" face="Arial"></font><br></div></div><div><div></div><div class="h5">Hi folks,<br><br>One of the goals for the Pycon sprint
was to develop user oriented overviews for existing documentation.<br>These
would ideally guide users through everything they would need to read in order
to accomplish a desired goal with Twisted.<br><br>I've formulated the
following 'track' suggestions based on a conversation in the sprint room a few
nights ago.<br>Feedback would be greatly
appreciated.<br><br>---<br><br>Overviews<br><br># The basics of event
driven applications (beginner)<br><br># No hand holding, just the
facts (advanced, already familiar with concepts involved)<br><br>#
Testing Twisted applications<br><br># Driving processes
(interactively or otherwise)<br><br># Custom
protocols<br><br># When it makes sense to use
threads<br><br># Persisting application data (Would cover various
options including Axiom)<br><br># Task scheduling (Would cover
various options including Axiom)<br><br># Web
clients<br><br># Web applications using just
Twisted<br><br># Web applications using WSGI (Maybe show how to
run Django)<br><br># Mail clients<br><br># Mail
servers<br><br># SSH clients<br><br># SSH
servers<br><br># XMPP (Jabber) clients<br><br># XMPP
(Jabber) servers<br><br># Multiple servers in a single
application<br><br># GUI applications (non
web)<br><br># Networked video games<br>
</div></div><p>
</p><hr><div class="im">
<p></p>_______________________________________________<br>Twisted-Python
mailing
list<br><a href="mailto:Twisted-Python@twistedmatrix.com" target="_blank">Twisted-Python@twistedmatrix.com</a><br><a href="http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python" target="_blank">http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python</a><br>
</div></blockquote></div>
<br>_______________________________________________<br>
Twisted-Python mailing list<br>
<a href="mailto:Twisted-Python@twistedmatrix.com">Twisted-Python@twistedmatrix.com</a><br>
<a href="http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python" target="_blank">http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python</a><br>
<br></blockquote></div><br><br clear="all"><br>-- <br>01100011 01100001 01110010 01111001<br>