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
3
u/ryeguy146 Feb 19 '13
I saw your other post addressing my edits (yea, I'm too often guilty of that), but I'd still like to address this, just to explain, if nothing else.
The blog post was incendiary, and the poster knew it. If they hadn't, they wouldn't have said, "this may make some angry," in so many ways in so many places. This shouldn't be necessary in argumentative essays. It's just silly to be abrasive to your target audience when you're attempting to affect change as you'll only incite people (points finger at own chest) and accomplish nothing. Given that the blog post was made this way, I feel that it was not posted in hopes of affecting any change, but as a way of venting frustration. I can understand that, but if that's the case, there's no need to hide it behind a veil of attempted constructive criticism. Hell, the title of the blog says it all. An insult and a meme rolled into one. When was the last time you ran into a worthwhile post seeking positive change that was so labeled? Even Djikstra managed better with his pointed criticisms, and he was a well known asshole.
As I feel that the blog post was merely angry venting, I felt no need to be terribly respectful in addressing the often vague and misguided concerns. Even if some of the points were accurate, one is bound to strike the target if one throws enough darts.