Python Forum
Why Python's standard library is hard to read? - Printable Version

+- Python Forum (https://python-forum.io)
+-- Forum: Python Coding (https://python-forum.io/forum-7.html)
+--- Forum: Data Science (https://python-forum.io/forum-44.html)
+--- Thread: Why Python's standard library is hard to read? (/thread-1694.html)



Why Python's standard library is hard to read? - landlord1984 - Jan-20-2017

Are you guys generally search and read from here: https://docs.python.org/3/library/functions.html#filter  ?

I found it is hard to read. Maybe it is my personal feeling. But I can easily read C++ and Matlab's documentation. And they provide at least one example for each function's documentation.

Or using google at most of time for learning Python?

Thanks,

L


RE: Why Python's standard library is hard to read? - micseydel - Jan-20-2017

That seemed fine to me. The comprehension expression seemed like a decent example, though I get what you mean that it could be more explicit. Maybe this is a bad example of bad docs though, since filtering seems simpler to me than perhaps some other functions.


RE: Why Python's standard library is hard to read? - ichabod801 - Jan-20-2017

I've always found Python's documentation to be quite good, except for things like numpy. I agree that it could use an example rather than just a pythonym.