This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author hniksic
Recipients docs@python, hniksic, xtreak
Date 2018-08-27.13:22:24
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1535376144.86.0.56676864532.issue34518@psf.upfronthosting.co.za>
In-reply-to
Content
That's exactly it, thanks! I have no idea how I missed it, despite looking (I thought) carefully.

But yes, they should be linked from https://docs.python.org/3/library/stdtypes.html . Just as currently there is https://docs.python.org/3/library/stdtypes.html#generator-types that links to https://docs.python.org/3/reference/expressions.html#yieldexpr , there could be a #coroutine-types that links to https://docs.python.org/3/reference/datamodel.html#coroutine-objects

Another place to link is https://docs.python.org/3/glossary.html#term-coroutine - it currently does link to the reference, but only to the "async def" syntax.

Since https://docs.python.org/3/reference/compound_stmts.html#async-def is linked from many places, it might make sense to mention that *calling* a coroutine immediately returns a coroutine object, with a link to https://docs.python.org/3/reference/datamodel.html#coroutine-objects
History
Date User Action Args
2018-08-27 13:22:24hniksicsetrecipients: + hniksic, docs@python, xtreak
2018-08-27 13:22:24hniksicsetmessageid: <1535376144.86.0.56676864532.issue34518@psf.upfronthosting.co.za>
2018-08-27 13:22:24hniksiclinkissue34518 messages
2018-08-27 13:22:24hniksiccreate