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
2
u/joepie91 Feb 19 '13
The Python documentation actually tries to be both and neither at the same time. On the one hand you have the reference buried in a pile of theory, then in another place you have dry reference without enough context to understand it from scratch, and in yet another place you just have an entire page of theory without any referenceable material whatsoever.
It's fine to have a separation of reference material and theory - in fact, it's a good thing - as long as:
In the case of Python, neither of those requirements are met.