[issue40526] documentation bad on asyncio

Yury Selivanov report at bugs.python.org
Wed May 6 14:01:32 EDT 2020


Yury Selivanov <yselivanov at gmail.com> added the comment:

> If so, the main purpose of that example is just to demonstrate basic async/await syntax, and show asyncio.run() for a trivial case to clearly show how it's used at a fundamental level; it's intentional that the more involved examples that demonstrate asynchronous programming are contained in https://docs.python.org/3/library/asyncio-task.html#coroutine. Also, the example is simple and condensed enough that it requires zero additional explanation or context, as should be the case for a simple "hello world" example. Consider the perspective of someone who found the page without having previously seen async/await syntax used.

Yes, exactly.

----------
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue40526>
_______________________________________


More information about the Python-bugs-list mailing list