[docs] [issue24087] Documentation doesn't explain the term "coroutine" (PEP 342)
report at bugs.python.org
Mon Jun 15 16:47:29 CEST 2015
Paul Moore added the comment:
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 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.
 For example, how Python's implementation differs from other languages or "theoretical" discussions of coroutines in the literature.
Python tracker <report at bugs.python.org>
More information about the docs