[Twisted-Python] Deferred documentation rewrite

2009-07-30 Thread Edward Z. Yang
Hello all, I have been prodded by the members of #twisted into rewriting the Deferred documentation. You can check out the plan at this ticket: http://twistedmatrix.com/trac/ticket/3943 Comments would be appreciated. Cheers, Edward P.S. If you reply on the mailing list, please CC me. ___

Re: [Twisted-Python] Deferred documentation rewrite

2009-07-31 Thread Edward Z. Yang
You can view an initial draft of the rewrite here: http://ezyang.com/twisted/defer2.html For reference, this is the planned outline (X means done, ? means almost done): X Synchronous to Asynchronous: The Method to the Madness X Convert synchronous code to asynchronous code X Why asynchro

Re: [Twisted-Python] [Fwd: Re: Deferred documentation rewrite]

2009-07-31 Thread Edward Z. Yang
Excerpts from Itamar Shtull-Trauring's message of Fri Jul 31 22:26:29 -0400 2009: > The problem with this is that it perpetuates the misunderstanding the > Deferreds *make* things asynchronous, even with the intro that says > otherwise. I think it's better to assume already asynchronous code, > ha

Re: [Twisted-Python] Deferred documentation rewrite

2009-08-03 Thread Edward Z. Yang
I have updated my draft here: http://ezyang.com/twisted/defer2.html The most notable change is I've removed the section "From Synchronous to Asynchronous". I believe (and I think other people agree with me) that this is an important topic to cover, but it's really *hard* to teach asynchronou

Re: [Twisted-Python] Deferred documentation rewrite

2009-08-04 Thread Edward Z. Yang
Thanks! I've updated the docs accordingly. Cheers, Edward ___ Twisted-Python mailing list Twisted-Python@twistedmatrix.com http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python