[Doc-SIG] [Python-Dev] [Preview] Comments and change proposals on documentation
g.brandl at gmx.net
Sat Nov 27 21:47:24 CET 2010
Am 27.11.2010 12:24, schrieb Nick Coghlan:
> On Sat, Nov 27, 2010 at 7:28 AM, Fred Drake <fdrake at acm.org> wrote:
>> On Fri, Nov 26, 2010 at 3:52 PM, average <dreamingforward at gmail.com> wrote:
>>> Anonymous comments good too...
>> I suspect anonymous comments fall into the same category as anonymous
>> issue tracker submissions. We've disallowed those for good reasons,
>> and those make sense in this case as well.
> Are you sure about that?
> The problem with general tracker submissions is that we almost always
> need additional information from the original submitter (what version,
> what platform, does it work if you try version X+1, etc). Opening up
> anonymous submissions would just mean more work for tracker folks in
> trying to reproduce the problems, failing and then closing them as
> "works for me" or "not enough information". None of those reasons
> apply to doc comments - "this is wrong", "this is unclear and would be
> better worded as 'make sure to do X before doing Y'" are potentially
> useful even if the docs editors never hear from the submitter ever
> again. The key difference is that the doc maintainers don't need to
> try to reproduce anything - they just read the comment, decide whether
> or not they agree with it and then either apply it, modify and then
> apply it, or else deep-six it, never to be seen again.
I agree. I'd rather put in aggressive spam-filtering than block anonymous
comments; this commenting really is about easy and quick feedback rather
than an involved process.
That said, it really depends on how people are using the comment feature
once it's in place. If we see too many unqualified or nonsense comments
from anonymous users, we can still decide to block them.
More information about the Doc-SIG