3 ms·
What even does "the list of methods" mean? Do you mean the builtins? Those are at the docs for built in functions.[1] Or do you mean the list of all functions?
by Doxin 9y ago
What even does "the list of methods" mean? Do you mean the builtins? Those are at the docs for built in functions.[1] Or do you mean the list of all functions? Because that doesn't exist for the very good reason that it doesn't make sense to have a list like that for python. There's the module index[2] though which lists every available module, linking to their docs which list all the available functions in those modules.
Having a single list of all functions in python makes very little sense for the simple reason that you'd not be able to find what you're looking for in that list so you might as well just use the search in the first place.
Side note: if there's a specific function you'd like to get the documentation for you can get that easily from the interactive python prompt with the "help" function:
>>> help(zip)
And I fail to see the "missing examples". While it's true that most modules don't contain examples for every single function they usually contain a few examples for the overarching concept.
So which part exactly of the python docs is bad? IMO they are, by far, the best docs any programming language has.
[1] https://docs.python.org/3/library/functions.html https://docs.python.org/3/library/functions.html
[2] https://docs.python.org/3/py-modindex.html https://docs.python.org/3/py-modindex.html
- nl 9y agoYes, I realize I can use help. Does it being available in one place mean that it shouldn't be available in others? If I'm in an IDE I don't always have the command prompt in front of me, and that should be fine! So here's the standard library page for Python lists: https://docs.python.org/3/library/stdtypes.html#sequence-types-list-tuple-range https://docs.python.org/3/library/stdtypes.html#sequence-typ... As a new python programmer, how am I supposed to know that the comprehensive API docs are actually in the tutorial? https://docs.python.org/3.1/tutorial/datastructures.html https://docs.python.org/3.1/tutorial/datastructures.html Compare that to Javadocs (something Java got right!): https://docs.oracle.com/javase/8/docs/api/java/util/List.html https://docs.oracle.com/javase/8/docs/api/java/util/List.htm..., and .NET is similar. Ruby is also ok in this regard: https://ruby-doc.org/core-2.2.0/Array.html https://ruby-doc.org/core-2.2.0/Array.html (Javascript is a mess of course!)