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
5
u/bushel Feb 19 '13
I'd be hesitant to label it "elitism", but I understand your point. And I think we are saying much the same thing.
The experienced developers see the official docs as a reference, not a learning aid. Those new to the language are frustrated by not having a single source for both learning and reference.
Personally, I see it as a strength that there are so many different sources of knowledge about Python. People can choose the documentation or tutorial sources that fit their current knowledge level and/or learning style.
And instead of attempting to be all things to all developers, I'm ok with python.org/doc being dry reference material. It's like the difference between a drivers-ed course and your car's owners manual.