Deferred howto should demonstrate loops involving asynchronous functions

	@jonathanj reported
Trac ID	trac#6387
Type	enhancement
Created	2013-03-22 17:39:30Z

In my experience, new users often have a hard time conceptualising how to work with asynchronous functions when performing loops.

The new Deferred howto draws parallels between a number of synchronous constructs, such as try/except, and their asynchronous counterparts, but despite having an example of a synchronous loop it does not go into detail about similar things involving asynchronous functions. I feel that some prose on the topics of, but not limited to, gathering results or serialising async tasks would benefit newcomers.

trac-id__6387 6387
type__enhancement enhancement
reporter__jonathanj jonathanj
priority__normal normal
milestone__ 
branch__ 
branch_author__ 
status__new new
resolution__None None
component__core core
keywords__deferred_howto_documentation deferred howto documentation
time__1363973970000000 1363973970000000
changetime__1363973970000000 1363973970000000
version__None None
owner__ 

Start by reading the existing Deferred howto and its synchronous loop example. Add newcomer-focused prose and examples covering asynchronous loops, including gathering results and serialising async tasks. Done means the howto clearly explains these loop patterns alongside its existing synchronous comparisons.