[issue39034] Documentation: Coroutines

[Rustam Agakishiev]

New submission from Rustam Agakishiev <agakishy at gmail.com>:

Here: https://docs.python.org/3/library/asyncio-task.html  
it says:"To actually run a coroutine, asyncio provides three main mechanisms:"

and a few pages down it gives you a fourth mechanism:
"awaitable asyncio.gather(*aws, loop=None, return_exceptions=False)
Run awaitable objects in the aws sequence concurrently."

And it really runs awaitables:
future = asyncio.gather(*awslist) # aws are run...
...                               # some other heavy tasks
result = async future             # collect results

Shouldn't it be added to docs?

----------
assignee: docs at python
components: Documentation
messages: 358320
nosy: agarus, docs at python
priority: normal
severity: normal
status: open
title: Documentation: Coroutines
type: enhancement
versions: Python 3.7

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