[issue40405] asyncio.as_completed documentation misleading

[Kyle Stanley]

Kyle Stanley <aeros167 at gmail.com> added the comment:

Yury Selivanov wrote:
> I'd suggest to change to: "Return an iterator of coroutines.  Each coroutine allows to wait for the earliest next result from the set of the remaining awaitables."

The first sentence looks good to me, but I'm not certain about the second sentence, particularly "allows to wait". Instead, I'm thinking something like this might read better:

"Each coroutine represents the earliest next result from the set of the remaining awaitables, based upon the order of completion."

Thoughts?

----------
nosy: +aeros

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