Minor documentation issues in asyncio BaseEventLoop

[Spycho]

Firstly:

cpython/Lib/asyncio/events.py

Line 620 in a2d54d4

Returns an event loop object implementing the BaseEventLoop interface,

I think the AbstractEventLoopPolicy's get_event_loop function should not say:

Returns an event loop object implementing the BaseEventLoop interface

But rather:

Returns an event loop object implementing the AbstractEventLoop interface

AbstractEventLoop is more of a representation of the interface than BaseEventLoop, and AbstractEventLoop is the class that the docs instruct people to extend if they want to have a custom event loop, and specifically say to not extend BaseEventLoop. It's also easier to look at the interface via AbstractEventLoop, without all the implementation details getting in the way.

Secondly:

cpython/Lib/asyncio/base_events.py

Line 730 in 64c0890

are scheduled for exactly the same time, it undefined which

Grammar error:

If two callbacks are scheduled for exactly the same time, it undefined which will be called first.

should read:

If two callbacks are scheduled for exactly the same time, it is undefined which will be called first.

Linked PRs

• gh-106634: Corrected minor asyncio doc issues #106671
• [3.11] gh-106634: Corrected minor asyncio doc issues (GH-106671) #106711
• [3.12] gh-106634: Corrected minor asyncio doc issues (GH-106671) #106712

[Spycho]

I'm happy to fix it and create a PR.

[gvanrossum]

Go ahead and create a PR. The Abstract/Base issue is worthy of fixing, the other can be fixed while you're at it.