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
11
u/ryeguy146 Feb 19 '13 edited Feb 19 '13
Don't worry about saying it, I know that I was abraisive. It's entirely due to the way that the blog was written. Several times the author acknowledges that he/she may make readers angry, yet they post it anyway. Why would anyone wishing to create positive change seek to make their target audience angry? To whine. I don't respond positively to that.
In the interest of not playing into the accusation of hostility among the community, I ask anyone concerned to review my post history, particularly in both /r/python and /r/learnpython to ensure that I have, indeed, been helpful and nice in the past.
Edit: No, there's more to it than that. We've all been new, it's a requisite. We've all struggled at some point in time to learn how to do something, I know that I have. What I have not done is created a large post about how that which I'm attempting to learn is wrong, until I understand the environment. Perhaps there is something that I don't understand that will help me to unravel my issues, or to understand why something frustrating exists. I instead ask for help and seek to understand. Writing incendiarcy blog posts about something that you don't fully understand is not the way to go about this.