Author paul.moore
Recipients docs@python, gvanrossum, martin.panter, paul.moore
Date 2015-06-15.14:47:28
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1434379649.13.0.924897072812.issue24087@psf.upfronthosting.co.za>
In-reply-to
Content
Personally, I'm OK with the wording in the 3.5.0b2 docs, as far as basic terminology and glossary-style information goes.

I think coroutines, async, and event loops are badly under-documented in the broader context, though - there is very little in the docs explaining the concepts and constraints[1] of Python's async features. Unfortunately, the people with the knowledge of the subject are likely to be too close to the details to be able to write beginner-level documentation, and beginners don't know enough (by definition) to do so. I'm trying to do some playing round with creating my own async framework to get a better understanding of how things should work, but it's slow going and honestly I don't feel I've got anything much I could write up at this point.

[1] For example, how Python's implementation differs from other languages or "theoretical" discussions of coroutines in the literature.
History
Date User Action Args
2015-06-15 14:47:29paul.mooresetrecipients: + paul.moore, gvanrossum, docs@python, martin.panter
2015-06-15 14:47:29paul.mooresetmessageid: <1434379649.13.0.924897072812.issue24087@psf.upfronthosting.co.za>
2015-06-15 14:47:29paul.moorelinkissue24087 messages
2015-06-15 14:47:28paul.moorecreate