stdtypes don't mention asyncio generic classes

[asvetlov]

Documentation

https://docs.python.org/3/library/stdtypes.html#standard-generic-classes has a list of generic classes. Since ea5b968, asyncio provides generic Future and Task that are not mentioned.

Linked PRs

• gh-131417: Mention asyncio Future and Task in docs for generic classes list #131422
• [3.13] gh-131417: Mention asyncio Future and Task in docs for generic classes list (GH-131422) #131445
• [3.12] gh-131417: Mention asyncio Future and Task in docs for generic classes list (GH-131422) #131446

[JelleZijlstra]

Note the list explicitly says it's not exhaustive. I don't object to adding the asyncio ones but maybe we should trim down the list to builtin types instead.

[gvanrossum]

I personally think it's nuts trying to keep such a list up to date. What is it even useful for? Maybe we can just remove it?

[AA-Turner]

Could we say something like?:

'Many types in the standard library can be parameterised, including each of the built-in collection types and all of the types in collections.abc. Refer to the documentation for a specific class for information on its support for parameterised generics'

I agree with Guido that having such a long list isn't very helpful, especially now that generics are so widely supported in the stdlib (I didn't even realise the list existed).

A