Closed as not planned
Description
Documentation
As evidenced by GH-108427, the current example for asyncio.shield()
may be confusing. The example:
cpython/Doc/library/asyncio-task.rst
Lines 588 to 601 in c7d68f9
I personally find the existing text to be clear enough, but I'm also a native English speaker and have read the entire sample :). My only suggestion for a minor improvement would be to move the "except" to the front in the form of "In the absence of cancellation, the statement::" or similar.
I'd also be happy to just close this issue as "won't fix", but it seemed worth opening the discussion if I happen to be in a minority finding it clear.
Metadata
Metadata
Assignees
Projects
Status
Done