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 yselivanov
Recipients akuchling, asvetlov, docs@python, yselivanov
Date 2018-05-25.19:48:42
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <>
An overhaul of asyncio documentation is long overdue.  Here's the structure for it that I have in mind:

- Introduction
(what is asyncio and async/await)

- A quick tutorial
(show how to use and basic functions like asyncio.sleep() and teach that asyncio programs are all about async/await and *not* about callbacks or event loops)

- High-level APIs
(Tasks, Streams, Subprocesses, few other functions)

- Low-level APIs
  - Preface (talk a bit about everything: what's an event loop, what is a Future and a Transport)
  - Futures
  - Event loop APIs
  - Transports and Protocols (when to use and when not to use them)

- Tutorials
  - High-level networking server
  - HTTP application
  - Low-level protocol implementation using Transports
  - etc
Date User Action Args
2018-05-25 19:48:42yselivanovsetrecipients: + yselivanov, akuchling, asvetlov, docs@python
2018-05-25 19:48:42yselivanovsetmessageid: <>
2018-05-25 19:48:42yselivanovlinkissue33649 messages
2018-05-25 19:48:42yselivanovcreate