[issue45352] Move documentation for typed generic forms of standard collections to collections.abc

Change by Terry J. Reedy : -- stage: -> needs patch versions: +Python 3.11 ___ Python tracker ___ ___ Python-bugs-list mailing

[issue45352] Move documentation for typed generic forms of standard collections to collections.abc

Guido van Rossum added the comment: I'm not against additional tutorial for typing. But the standard library manual is supposed to be a complete reference. There is enough variation between different generic types (e.g. are the parameters covariant?) that ought to be documented. I don't

[issue45352] Move documentation for typed generic forms of standard collections to collections.abc

Ken Jin added the comment: > I think those should go with the individual types as well The list[] and dict[] stdtypes are in a different document from collections.abc.*. While this helps logical separation, I feel like it'd be tougher searching for type information compared to our current

[issue45352] Move documentation for typed generic forms of standard collections to collections.abc

Guido van Rossum added the comment: > Where are capabilities like "list[str]" and "dict[str, list[int]]" going to > be documented? I think those should go with the individual types as well. AFter all, it's specific to the type how many parameters it has and what they mean. There should

[issue45352] Move documentation for typed generic forms of standard collections to collections.abc

Raymond Hettinger added the comment: Where are capabilities like "list[str]" and "dict[str, list[int]]" going to be documented? -- ___ Python tracker ___

[issue45352] Move documentation for typed generic forms of standard collections to collections.abc

Guido van Rossum added the comment: I think we should go ahead and duplicate the documentation in collections.abc (and in a few other places -- PEP 585 lists some builtins, some in contextlib, some in re). Then we won't have to worry about what happens when the typing module is slimmed down

[issue45352] Move documentation for typed generic forms of standard collections to collections.abc

Change by Ken Jin : -- nosy: +gvanrossum, kj, rhettinger, stutzbach ___ Python tracker ___ ___ Python-bugs-list mailing list

[issue45352] Move documentation for typed generic forms of standard collections to collections.abc

New submission from Patrick Reader : Currently the documentation for the generic forms (e.g. what the parameters in square brackets mean) of standard collections (e.g. collections.abc.Generator), is still on the typing page (https://docs.python.org/3.10/library/typing.html#typing.Generator).