3 ms·
The author also has experience teaching beginners (presumably), giving them a perspective that experienced programmers very easily forget and/or ignore.
by Flimm 10y ago
The author also has experience teaching beginners (presumably), giving them a perspective that experienced programmers very easily forget and/or ignore.
- thewhitetulip 10y agoOn the contrary, I learned python starting with the docs, and I am very picky, if something is difficult to understand I am the first to complain, but I did find python docs to be okay, considering I started learning the language from the docs itself. They might not be the best, but they aren't what the author says like 'we just can't understand shit'
- dkersten 10y agoI learned python purely from an offline copy of the official docs, back in 2001 or so. It was obviously doable, since I did learn Python, but it wasn't particularly easy and I remember starting to really like Microsofts documentation (eg their VB docs). Python's docs have improved, but they're not amazing. Then again, neither are the docs for many other languages. For example, I'm a big fan of Clojure, but many of the docs there have me really appreciating Python's docs ;-) I think once you get used to Pythons docs, they're pretty easy to follow, although I agree that type information on arguments/return values would be great and I also largely work from examples unless I'm already familiar with a library and am just looking for reference material.
- thewhitetulip 10y agoThat's what my point it, the author, in my opinion is wrong about the docs, since even I learned the language entirely from an offline html copy of the docs.
- dkersten 10y agoYeah, I wasn't disagreeing with you. Just adding my own anecdote.
- thewhitetulip 10y agoYes, I know that :-) Sorry for being unclear in my comments!!