Feb 3, 2026 · Feb 4, 2026
diff --git a/Doc/library/asyncio-task.rst b/Doc/library/asyncio-task.rst
    The context manager produced by:func:`asyncio.timeout` can be
    rescheduled to a different deadline and inspected.

    ..note::

       Prefer using:func:`asyncio.timeout` or:func:`asyncio.timeout_at`
       rather than instantiating:class:`Timeout` directly.

    ..class::Timeout(when)

       An:ref:`asynchronous context manager<async-context-managers>`
Original file line number	Diff line number	Diff line change
Expand Up		@@ -766,6 +766,11 @@ Timeouts
		The context manager produced by:func:`asyncio.timeout` can be
		rescheduled to a different deadline and inspected.

		..note::
Copy link Member picnixzFeb 4, 2026 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. After looking at the generated doc, I think a note is a bit too loud. OTOH, I feel that having`Timeout` inside the docs of`timeout` is also wrong. My suggestion is to put it as a real documented class (outside the function description) and put that note there. @kumaraditya303 How do you want the docs to be eventually rendered?

		Prefer using:func:`asyncio.timeout` or:func:`asyncio.timeout_at`
		rather than instantiating:class:`Timeout` directly.

		..class::Timeout(when)

		An:ref:`asynchronous context manager<async-context-managers>`
Expand Down