[docs] [issue35631] Improve typing docs wrt abstract/concrete collection types

[Ville Skyttä]

New submission from Ville Skyttä <ville.skytta at iki.fi>:

The typing docs for List includes a note to use generic collection types, but lists AbstractSet and Mapping which aren't generally replacements for a List. It would be better to remove those types from the List note and add corresponding ones to Dict and Set which are currently lacking it.

Additionally, some examples in the typing docs are in violation of the above stated preference, using Lists and Dicts as parameters.

----------
assignee: docs at python
components: Documentation
messages: 332842
nosy: docs at python, scop
priority: normal
severity: normal
status: open
title: Improve typing docs wrt abstract/concrete collection types
type: enhancement

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35631>
_______________________________________