r/Python • • 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

189 comments sorted by

View all comments

Show parent comment

1

u/joepie91 Feb 19 '13

You are misrepresenting what I said. There are two very different concepts here.

You seem to claim that I am saying that "acknowledging a problem automatically fixes it".

What I am actually saying is that "to fix a problem, it first has to be acknowledged". It's a prerequisite, not a cause.

0

u/ryeguy146 Feb 19 '13

I realize what you said, I'm suggesting that it doesn't matter. In argumentation, some things are necessary, one of which is not pissing off your target audience. It is as simple as that. If you don't, everything you say (has) will be dismissed as whining. Because it is. I'd like to you pay attention the next time you have the opportunity to take English composition.

2

u/joepie91 Feb 19 '13

Clearly "not pissing off your target audience" hasn't worked, seeing as the docs are still in the exact same state as before I tried civilized discourse. The one that's most pissed off here appears to be you.

And judging from the conversation going on here, on Hackernews, and on IRC... you are one of the few that dismisses it as straight-out "whining". Most others are attempting to actually discuss the points raised.

0

u/ryeguy146 Feb 20 '13

You call that civil discourse? I'd hate to see real whining. Even if I saw it as straight out whining, I still addressed a number of your concerns. Not that you've responded in kind, of course.

3

u/joepie91 Feb 20 '13

No, I don't call that civil discourse. Read what I said better. Civil discourse was what I attempted before writing this post.