3 ms·
Do you think you can clarify? Most people seem to think that Python's docs are quite good — it's one of the things that originally brought me to Python, along w
by jacobian 14y ago
Do you think you can clarify? Most people seem to think that Python's docs are quite good — it's one of the things that originally brought me to Python, along with many others. If you can explain how they let you down perhaps we can do something to fix it?
- nayefc 14y agoSure. My main problem I find is actually finding what I need. Assume I want to read about the string split method. There are two places that I'd go to: http://docs.python.org/2/library/string.html http://docs.python.org/2/library/string.html http://docs.python.org/2/library/stdtypes.html http://docs.python.org/2/library/stdtypes.html I know the difference, but that's very confusing and annoying. It might be easier to have all string methods in one page, but separate them in terms of built-in standard library vs. the module ones. Then I came across: http://docs.python.org/release/2.5.2/lib/string-methods.html http://docs.python.org/release/2.5.2/lib/string-methods.html which is a cleaner version. Another thing I found in string a few days ago: the difference between capitalize() and title() on std string is not clarified at all in the docs.