[docs] [issue25501] Use async/await through asyncio docs

Brett Cannon report at bugs.python.org
Thu Oct 29 12:27:27 EDT 2015


Brett Cannon added the comment:

Once 3.4.4 launches the need to keep the docs synced with a version that doesn't support async/await goes away. And worrying about 3.3 isn't necessary since asyncio was added in 3.4.

So once 3.4.4 is released and we close the 3.4 branch to bugfixes can we update the docs in asyncio and add a note at the top saying the examples all use async/await from 3.5 and if you need 3.4 compatibility to please look at the 3.4 docs? Otherwise how long do you want to wait until we can start using async/await in the documentation? My worry is that people are going to blindly copy the examples and tweak them for their needs since the asyncio docs are a bit dense and thus just simply overlook the fact that async/await exists.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue25501>
_______________________________________


More information about the docs mailing list