Add docstrings to asyncio.Timeout

[JosephSBoyle]

Feature or enhancement

asyncio.Timeout doesn't have docstrings. (asyncio.timeout does though:) )

Pitch

Adding docstrings would increase the usability of this class.

Notes

I will open a PR for this shortly.

I envisage starting out copying from the docs: https://docs.python.org/3/library/asyncio-task.html#asyncio.Timeout
and hammering out the wording in the PR, similar to what was done for asyncio.TaskGroup in #102560.

Linked PRs

• gh-102810 Add docstrings to the public facing methods of the Timeout class #102811
• [3.11] gh-102810: Add docstrings to the public-facing methods of asyncio.Timeout (GH-102811) #102834
• gh-102810 Improve the sphinx docs for asyncio.Timeout #102934
• [3.11] gh-102810 Improve the sphinx docs for asyncio.Timeout (GH-102934) #102958

[gvanrossum]

(Process note for the future: We don't require issues for adding docs or docstrings -- we'll set the "skip issue" label on the PR. Though we might sometimes create such issues to solicit contributions. Anyway, I'll review the PR this weekend.)

[JosephSBoyle]

Closing as done, thanks for the help on this!

[AlexWaygood]

Closing as done, thanks for the help on this!

#102811 (comment) is still to do!

[JosephSBoyle]

Aha okay, I was thinking of creating a new issue to plan the changes but I'll draft a PR sometime in the next couple of days and we can just discuss things on there:)

[AlexWaygood]

Thanks @JosephSBoyle!