[issue33649] asyncio docs overhaul

Guido van Rossum added the comment: New changeset 9d74658f0a6e8a9b8d6dcf199dda886f35c6ad68 by Joel Rosdahl in branch 'master': bpo-40499: Mention that asyncio.wait() needs a non-empty aws set (GH-19900) https://github.com/python/cpython/commit/9d74658f0a6e8a9b8d6dcf199dda886f35c6ad68

[issue33649] asyncio docs overhaul

Change by Joel Rosdahl : -- nosy: +jrosdahl nosy_count: 14.0 -> 15.0 pull_requests: +19213 pull_request: https://github.com/python/cpython/pull/19900 ___ Python tracker ___

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: New changeset e45662c28bfc84aa3674463a2995e45da4d63793 by Yury Selivanov (Miss Islington (bot)) in branch '3.7': bpo-33649: Fix gather() docs; fix title; few other nits. (GH-9475) (GH-9481)

[issue33649] asyncio docs overhaul

Change by miss-islington : -- pull_requests: +8891 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: New changeset db1a80e97aa7217c561fb3627f70be1882de9534 by Yury Selivanov in branch 'master': bpo-33649: Fix gather() docs; fix title; few other nits. (GH-9475) https://github.com/python/cpython/commit/db1a80e97aa7217c561fb3627f70be1882de9534 --

[issue33649] asyncio docs overhaul

Change by Yury Selivanov : -- pull_requests: + ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

miss-islington added the comment: New changeset 8e5ef58c10a1154f824d5875c2d89794a800eadc by Miss Islington (bot) in branch '3.7': bpo-33649: More improvements (GH-9439) https://github.com/python/cpython/commit/8e5ef58c10a1154f824d5875c2d89794a800eadc --

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: New changeset e247b46cba4f4d32ea96a15dbc36d73265171106 by Yury Selivanov in branch 'master': bpo-33649: More improvements (GH-9439) https://github.com/python/cpython/commit/e247b46cba4f4d32ea96a15dbc36d73265171106 --

[issue33649] asyncio docs overhaul

Change by miss-islington : -- pull_requests: +8869 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Change by Yury Selivanov : -- pull_requests: +8853 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

miss-islington added the comment: New changeset 73c0006e71683b7d5b28192f18a2b9796e4195ef by Miss Islington (bot) in branch '3.7': bpo-33649: Add a high-level section about Futures; few quick fixes (GH-9403) https://github.com/python/cpython/commit/73c0006e71683b7d5b28192f18a2b9796e4195ef

[issue33649] asyncio docs overhaul

Change by miss-islington : -- pull_requests: +8831 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: New changeset 471503954a91d86cf04228c38134108c67a263b0 by Yury Selivanov in branch 'master': bpo-33649: Add a high-level section about Futures; few quick fixes (GH-9403) https://github.com/python/cpython/commit/471503954a91d86cf04228c38134108c67a263b0

[issue33649] asyncio docs overhaul

Change by Yury Selivanov : -- pull_requests: +8826 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

miss-islington added the comment: New changeset 45452b738b7f94221a94e903fb5975222fbb7a8f by Miss Islington (bot) in branch '3.7': bpo-33649: Fix markup; add another note that asyncio.run is 3.7+ (GH-9389) https://github.com/python/cpython/commit/45452b738b7f94221a94e903fb5975222fbb7a8f

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: New changeset b042cf10c6084d14279c55a7e0d2d7595ff4e694 by Yury Selivanov in branch 'master': bpo-33649: Fix markup; add another note that asyncio.run is 3.7+ (GH-9389) https://github.com/python/cpython/commit/b042cf10c6084d14279c55a7e0d2d7595ff4e694

[issue33649] asyncio docs overhaul

Change by miss-islington : -- pull_requests: +8814 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Change by Yury Selivanov : -- pull_requests: +8813 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Change by miss-islington : -- pull_requests: +8812 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Change by Miguel Ángel : -- pull_requests: +8811 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Change by miss-islington : -- pull_requests: +8810 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Change by Danny Hermes : -- pull_requests: +8809 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Change by Miguel Ángel : -- pull_requests: +8808 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

miss-islington added the comment: New changeset 1f4ea580675d7b30d3906d78c500997d7d96995d by Miss Islington (bot) in branch '3.7': bpo-33649: Note that asyncio.run() calls shutdown_asyncgens() (GH-9380) https://github.com/python/cpython/commit/1f4ea580675d7b30d3906d78c500997d7d96995d

[issue33649] asyncio docs overhaul

Change by miss-islington : -- pull_requests: +8807 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: New changeset ac94e38d076aebc56c2ff96a249b5e40f32633ea by Yury Selivanov in branch 'master': bpo-33649: Note that asyncio.run() calls shutdown_asyncgens() (GH-9380) https://github.com/python/cpython/commit/ac94e38d076aebc56c2ff96a249b5e40f32633ea

[issue33649] asyncio docs overhaul

Ned Deily added the comment: >> Ned, do we auto run docs build for Python 3.7? Or do we only build them on >> release? The online html docs at https://docs.python.org/, like https://docs.python.org/3.7/, are rebuilt every 3 hours from the current branch heads for feature and maintenance

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: > Ned, do we auto run docs build for Python 3.7? Or do we only build them on > release? Never mind, the docs for 3.7 have been updated! -- ___ Python tracker

[issue33649] asyncio docs overhaul

Change by Yury Selivanov : -- pull_requests: +8804 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: Ned, do we auto run docs build for Python 3.7? Or do we only build them on release? -- nosy: +ned.deily ___ Python tracker ___

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: Wow, we did this! I've just pushed a backport of the new documentation to 3.7. Thanks to Carol, Elvis, and Andrew for the help! I think this issue can now be closed, we'll open new ones for: 1. A high-level intro/tutorial for asyncio. 2. A low-level

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: New changeset 512d7101098b971837cbb406942215244f636547 by Yury Selivanov in branch '3.7': bpo-33649: Backport asyncio docs from 'master' to 3.7 (GH-9377) https://github.com/python/cpython/commit/512d7101098b971837cbb406942215244f636547 --

[issue33649] asyncio docs overhaul

Change by Yury Selivanov : -- pull_requests: +8801 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: New changeset 1fa2ec49bec50bea1847b558b883c5c904334734 by Yury Selivanov (Elvis Pranskevichus) in branch 'master': bpo-33649: A copy-editing pass on asyncio documentation (GH-9376)

[issue33649] asyncio docs overhaul

Change by Elvis Pranskevichus : -- pull_requests: +8800 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: New changeset 3085534c398e6b181e7a9ac0cb9c80f3c670f2b9 by Yury Selivanov in branch 'master': bpo-33649: Add a hello world example to asyncio.rst (GH-9374) https://github.com/python/cpython/commit/3085534c398e6b181e7a9ac0cb9c80f3c670f2b9 --

[issue33649] asyncio docs overhaul

Change by Yury Selivanov : -- pull_requests: +8798 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: New changeset 394374e30c85f6eacddbbfc7471aab62b54ce021 by Yury Selivanov in branch 'master': bpo-33649: Add low-level APIs index. (GH-9364) https://github.com/python/cpython/commit/394374e30c85f6eacddbbfc7471aab62b54ce021 --

[issue33649] asyncio docs overhaul

Change by Yury Selivanov : -- pull_requests: +8788 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: New changeset 5cc583d94095ed3bb543fa2f032f9593a6315a52 by Yury Selivanov (Bumsik Kim) in branch 'master': bpo-33649: Clarify protocol_factory as a method parameter (GH-9330) https://github.com/python/cpython/commit/5cc583d94095ed3bb543fa2f032f9593a6315a52

[issue33649] asyncio docs overhaul

Change by Bumsik Kim : -- pull_requests: +8753 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: New changeset 805e27eff65d51f7aea2c00ccbb4f5d44f4499f2 by Yury Selivanov in branch 'master': bpo-33649: Fix asyncio-dev (GH-9324) https://github.com/python/cpython/commit/805e27eff65d51f7aea2c00ccbb4f5d44f4499f2 --

[issue33649] asyncio docs overhaul

Change by Yury Selivanov : -- pull_requests: +8749 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: New changeset 7372c3bbefb4763dbd1b6d66f7971bef28c0f056 by Yury Selivanov in branch 'master': bpo-33649: Add high-level APIs cheat-sheet (GH-9319) https://github.com/python/cpython/commit/7372c3bbefb4763dbd1b6d66f7971bef28c0f056 --

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: New changeset 6c7316439d966cdbc76ffcc005e5d9c563064ba2 by Yury Selivanov in branch 'master': bpo-33649: Refresh asyncio docs landing page (GH-9322) https://github.com/python/cpython/commit/6c7316439d966cdbc76ffcc005e5d9c563064ba2 --

[issue33649] asyncio docs overhaul

Change by Yury Selivanov : -- pull_requests: +8748 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Change by Yury Selivanov : -- pull_requests: +8744 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Carol Willing added the comment: New changeset 3faaa8857a42a36383bb18425444e597fc876797 by Carol Willing (Yury Selivanov) in branch 'master': bpo-33649: Refresh Tasks and Futures pages (#9314) https://github.com/python/cpython/commit/3faaa8857a42a36383bb18425444e597fc876797 --

[issue33649] asyncio docs overhaul

Change by Yury Selivanov : -- pull_requests: +8739 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Carol Willing added the comment: New changeset c9d66f0ed4f07b9d184d22abbfdd4c3c8e2702df by Carol Willing in branch 'master': bpo-33649 Polish asyncio docs on queues, protocols, and subproccesses (#9306) https://github.com/python/cpython/commit/c9d66f0ed4f07b9d184d22abbfdd4c3c8e2702df

[issue33649] asyncio docs overhaul

Change by Carol Willing : -- pull_requests: +8735 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

miss-islington added the comment: New changeset 4e824e96491f33c8a8462aa4970c55942064ae76 by Miss Islington (bot) (Carol Willing) in branch 'master': bpo-33649: Polish asyncio subprocess and sync docs (GH-9285) https://github.com/python/cpython/commit/4e824e96491f33c8a8462aa4970c55942064ae76

[issue33649] asyncio docs overhaul

Change by Carol Willing : -- pull_requests: +8715 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Change by Carol Willing : -- pull_requests: +8704 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: New changeset 5b7cbd602e57265604d6c099fd174b1c7917f861 by Yury Selivanov (Carol Willing) in branch 'master': bpo-33649: Edit asyncio eventloop doc - second pass (GH-9233) https://github.com/python/cpython/commit/5b7cbd602e57265604d6c099fd174b1c7917f861

[issue33649] asyncio docs overhaul

Change by Carol Willing : -- pull_requests: +8666 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Change by Carol Willing : -- pull_requests: +8664 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Bumsik Kim added the comment: Hi, I came from #33986. I noticed that the new doc still does not reflect a design change on SubprocessTransport.close() done in #23347. I made a PR to fix that. BTW this is opposed to the original PEP 3156:

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: New changeset aca819fb494d4801b3e5b5b507b17cab772c1b40 by Yury Selivanov (Bumsik Kim) in branch 'master': bpo-33649: Fix doc to reflect changes in 47cd10d (or bpo-23347) (GH-9219)

[issue33649] asyncio docs overhaul

Change by Bumsik Kim : -- pull_requests: +8651 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: New changeset 8be876e44b2dffb96b551029454cbfb16d697992 by Yury Selivanov in branch 'master': bpo-33649: Cleanup asyncio/streams and asyncio/synchronization docs (GH-9192) https://github.com/python/cpython/commit/8be876e44b2dffb96b551029454cbfb16d697992

[issue33649] asyncio docs overhaul

Change by Yury Selivanov : -- pull_requests: +8630 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Change by Karthikeyan Singaravelan : -- nosy: +xtreak ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: The first PR has been just landed. The plan is to work in 'master' branch and when the docs are ready we backport them to 3.7 in one big PR. So far the following files were updated/reviewed: Doc/library/asyncio-eventloop.rst

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: New changeset 7c7605ff1133cf757cac428c483827f666c7c827 by Yury Selivanov in branch 'master': bpo-33649: First asyncio docs improvement pass (GH-9142) https://github.com/python/cpython/commit/7c7605ff1133cf757cac428c483827f666c7c827 --

[issue33649] asyncio docs overhaul

Change by Yury Selivanov : -- keywords: +patch pull_requests: +8592 stage: -> patch review ___ Python tracker ___ ___

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: Status update: I'm working on a first rewrite. I expect to have something to review on a couple of weeks. -- ___ Python tracker ___

[issue33649] asyncio docs overhaul

Change by Martin Altmayer : -- nosy: +MartinAltmayer ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Jim DeLaHunt added the comment: I'm a developer using Python in my application. I just spent the last couple of weeks learning about asyncio with the present documentation. I am very happy to see that work is underway for improved documentation. I would be glad to take on writing tasks or

[issue33649] asyncio docs overhaul

Change by Alexander Belopolsky : -- nosy: +belopolsky ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33649] asyncio docs overhaul

Yury Selivanov added the comment: > Yury: do you want to do the re-organization into high- and low-level APIs? > If you'd like me to do it, I'll need a more explicit listing of which APIs > fall into which category. Sure, I'll update this issue tomorrow or the day after with a more

[issue33649] asyncio docs overhaul

A.M. Kuchling added the comment: The plan for updating things looks good, and I think the ordering of tasks is good -- rearranging the APIs is a pretty simple first step, and it matches other chapters in the Library Reference, which list more important modules first and more specialized

[issue33649] asyncio docs overhaul

Change by Ivan Levkivskyi : -- nosy: +levkivskyi ___ Python tracker ___ ___

[issue33649] asyncio docs overhaul

Change by Barry A. Warsaw : -- nosy: +barry ___ Python tracker ___ ___ Python-bugs-list

[issue33649] asyncio docs overhaul

New submission from Yury Selivanov : 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