Do you feel bad because of the Python docs?
Roy Smith
roy at panix.com
Wed Feb 27 20:26:36 EST 2013
In article <54967758-e84c-4b9c-a09c-10fbdbec230f at googlegroups.com>,
Rick Johnson <rantingrickjohnson at gmail.com> wrote:
> do you /really/ expect that people have the
> time to open an issue on the bug tracker?
There's a certain amount of socialism involved in OSS. "From each
according to his ability," really is the way it works. If your ability
is that you've discovered that the documentation isn't as good as it
should be, you owe the project a few minutes of your time to create a
ticket describing the problem (and, even better, suggesting how it could
be improved).
Looking at my bugs.python.org activity, I see I've opened 30 bugs over
the past 9-1/2 years. Of those, 16 were explicitly against the docs,
and a few more were of the "I'm not sure if this is a docs bug or a code
bug, but it doesn't do what it says it does" variety.
> Do you really think that everyone
> who uses python even knows about the bug tracker?
Everybody? No. But, anybody who uses OSS should understand that any
non-trivial project has a bug tracker. And even if they don't know
where it is, they should be capable of typing "python bug tracker" into
a search engine and finding it.
> Do you really think that people will believe that their opinion is
> worthy of placing on the bug tracker?
In my experience, it's far more likely for people to over-estimate the
important of their own opinion than to under-estimate it :-)
More information about the Python-list
mailing list