[issue34802] asyncio.iscoroutine() documentation is wrong

[Karthikeyan Singaravelan]

Karthikeyan Singaravelan <tir.karthi at gmail.com> added the comment:

Thanks for the report. I believe this was done as part asyncio docs overhaul and I am adding Yury here. The current docs link to #coroutine from asyncio.iscoroutine whereas the previous docs had the definition inline. I think this is clarified in #awaitables section but takes a round-trip and it's not in #coroutines section which is linked in asyncio.iscoroutine. The below is present in important note in #awaitables and may be this can be added to #coroutine too so that it's not last? Suggestions welcome 

> asyncio also supports legacy generator-based coroutines

I would suggest below for #coroutines :  

> Coroutines declared with async/await syntax is the preferred way of writing asyncio applications but asyncio also supports legacy generator-based coroutines.

Thanks

----------
nosy: +xtreak, yselivanov

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