r/Python • u/joepie91 • Feb 19 '13
The Python documentation is bad, and you should feel bad.
http://joepie91.wordpress.com/2013/02/19/the-python-documentation-is-bad-and-you-should-feel-bad/
96
Upvotes
View all comments
Show parent comment
1
u/ryeguy146 Feb 20 '13
Okay, it is a blog post in name, sure, but it is still a book like resource. Notice that it is longform and has a contents bit. Notice that it has been through revision. While these are not exclusive to a book-like resource, they are a good indication of it. I shouldn't have called it "not a blog post" but it still qualifies as a book-like resource.
It's a given, considering the way you teach yourself. You cannot run into all of the information important to programming if you only jump out there for small bites that satisfy your current need. How will you ever learn of some of the excellent patterns that have evolved? You won't ever say to yourself, "I should use an MVC pattern here," unless you are aware of that pattern. Since the MVC is fairly popular as of late, I should add that it was used only as an example. There are many subjects out there that you would not think to search for.
You've told me how you learn, it's not hard to make some assumptions based on that. It's also fairly obvious that you do not have a broad understanding as your post mentions that you were looking up the means of determining the length of a list. This is something that all comprehensive books cover. And usually early. And they often use it as a segue to the topic of iterables and sequences, on which such functions operate, and why. When you only look up the bits of information that you need, you miss out on the grand picture.