Message317709
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 asyncio.run() 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:42 | yselivanov | set | recipients:
+ yselivanov, akuchling, asvetlov, docs@python |
2018-05-25 19:48:42 | yselivanov | set | messageid: <1527277722.54.0.682650639539.issue33649@psf.upfronthosting.co.za> |
2018-05-25 19:48:42 | yselivanov | link | issue33649 messages |
2018-05-25 19:48:42 | yselivanov | create | |
|