gh-124668: Update asyncio doc landing page with examples

[xuantengh]

This PR aims to present asyncio common usages in the document landing page.

• Issue: The asyncio documentation is missing a landing page #124668

---

📚 Documentation preview 📚: https://cpython-previews--125594.org.readthedocs.build/

[cpython-cla-bot]

All commit authors signed the Contributor License Agreement.

[xuantengh]

Preview the changed landing page: https://cpython-previews--125594.org.readthedocs.build/en/125594/library/asyncio.html

[1st1]

-1 on covering low level API and especially the fragile get_event_loop() on the landing page.

Also -1 on using create_task -- we have asyncio.TaskGroup for this.

[1st1]

I honestly don't think this makes things clearer. It unloads too much content on the front page, making the page intimidating and also making the TOC links on top harder to notice. So I'm -1 on this.

[willingc]

Hi @xuantengh, Welcome to CPython!

While I appreciate your interest in working on the issue and opening a PR, I would prefer that we keep the asyncio main page straightforward. I understand that examples can be helpful; however, I think those examples should be put within the Guides and Tutorials section.

I left some general feedback on the original issue: #124668 (comment)

This also includes a screenshot of the current doc structure for asyncio.

I'm recommending that we close this PR. If you wish to add examples to another page, please do so in a new PR. Thanks! ☀️

[xuantengh]

Sure, I'll add examples in corresponding pages.