The documentation about asyncio.TaskGroup might portray it as a replacement for asyncio.gather

[why-not-try-calmer]

Documentation

I think the documentation be slightly adjusted to rule out the (possible) implication that asyncio.TaskGroup is a drop-in replacement / better alternative to asyncio.gather(). Both have their idiomatic uses cases, and asyncio.gather() works well for tasks that do not schedule tasks themselves, especially when the caller needs to consume their result as soon as possible (i.e.

re1, re2 = asyncio.gather(corou1(), corou2())

)

I have a branch implementing the proposed changed ready to be PR-ed

Linked PRs

• gh-98641: Task group vs gather #103644

[kumaraditya303]

I am not sure that we to explicitly say this, it depends on the user how they want to use it. For most part asyncio.TaskGroup is much better than gather.

[gvanrossum]

I just closed the PR, closing this as won't fix.