3 ms·
I think Python is the worst-documented large language I use. For ```list``` it says: Lists implement all of the common and mutable sequence operations. Lists
by matt4077 9y ago
I think Python is the worst-documented large language I use.
For ```list``` it says:
Lists implement all of the common and mutable sequence operations. Lists also provide the following additional method:
...where "common" and "mutable" are links.
Meaning: the methods of lists are strewn across three different location, four if you count the constructors above this sentence.
- anowlcalledjosh 9y agoSome context: the page documenting lists [0] is the same page that documents all* Python's built-in types; lists are documented in section 4.6.4, where section 4.6 is titled "Sequence Types — list, tuple, range". Many operations on a list are much the same as the methods on a tuple, so they are documented in one place – section 4.6.1 "Common Sequence Operations" – rather than duplicated in both the list and tuple documentation. Similarly, many of the methods supported by list are also supported by bytearray, so they are documented in 4.6.3 "Mutable Sequence Types" rather than duplicated. To get from the section on lists to the two sections describing the available methods involves pressing page-up twice. Hardly "strewn across three different location", and there's always help(list) if you really want a list of every supported method. *all the ones you'll use regularly, at least [0]: https://docs.python.org/3/library/stdtypes.html#lists https://docs.python.org/3/library/stdtypes.html#lists