The asyncio module needs documentation.  I'll work on this in time for the beta 1 release.  Until then, please refer to PEP 3156.

I need help!

There is one urgent issue: should the chapter on asyncio go into section 17 (Concurrent Execution) or section 18 (Interprocess Communication and Networking)???  It would seem that event loops and coroutines fit better in section 17, while transports and protocols fit better in section 18. :-(  HELP!!

After that, I need help writing the docs. Most of it can probably be copy-pasted from PEP 3156, but I haven't written Python docs for a long time and I could use some help with how to structure it.  Ideally we'd find some volunteers who enjoy writing documentation to take over this project.

In the mean time, I have a patch that adds a stub with a reference to the PEP, so people can at least navigate to the docs without already knowing the PEP number.  It adds it to section 17 for now.

> There is one urgent issue: should the chapter on asyncio go into
> section 17 (Concurrent Execution) or section 18 (Interprocess
> Communication and Networking)???

I'd put it in 18. Also, I'd move select and selectors from 17 to 18, so that only purely "execution" modules remain in 17, and anything network-related is in the same chapter.

I was thinking the same thing as Antoine.  18 fits in more closely to what I understand is the purpose of asyncio (the focus on IO).

OK. I accidentally committed the patch. Will move the three modules to the
ipc section now.

On Fri, Nov 22, 2013 at 11:47 AM, Eric Snow <report@bugs.python.org> wrote:

>
> Eric Snow added the comment:
>
> I was thinking the same thing as Antoine.  18 fits in more closely to what
> I understand is the purpose of asyncio (the focus on IO).
>
> ----------
> nosy: +eric.snow
>
> _______________________________________
> Python tracker <report@bugs.python.org>
> <http://bugs.python.org/issue19291>
> _______________________________________
>

Following patch stubs a couple of things, this is very crude though.

Thanks -- please just commit, we can iterate.

New changeset e4b7377a690a by Antoine Pitrou in branch 'default':
Issue #19291: add crude stubs to the asyncio docs
http://hg.python.org/cpython/rev/e4b7377a690a

I've done a bit of it now, I'll let other people continue.

> I've done a bit of it now, I'll let other people continue.

I continued the work on the documentation. Even if it's not complete, I consider that the initial issue "Add docs for asyncio package (Tulip, PEP 3156)" is done, and so I close the issue.