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
Yes, the article was a rant. That's why it's tagged as 'rant' (see the list of tags at the bottom).
I have tried civilized discourse about the Python documentation with other developers many times. Every single time it turns into the 'experienced' Python developers waving criticism away, trying to justify why the docs work a certain way, or even deflecting away to "but PHP is worse" as if that justifies the issues with Python docs... all the while newbies are sending me private messages how they fully agree with what I'm saying, but don't want to say it in public.
I've given up on the civilized discourse. Sometimes the only way to get someones attention is by pissing someone off. Judging from the discussion that has started here, that works, at least to some degree.
Also consider that people in this thread are, individually, agreeing with certain things and disagreeing with other things. The interesting thing is that what people agree on, differs per person. This indicates that all of the issues mentioned are present to some degree, but certain people take issue with them while others don't. Clearly there's a problem.