FYI, I find it hard to follow an issue when folks edit descriptions and comments.

I think the best practice is to submit issues whose description briefly describes the problem. Then comments can be used to elaborate on the problem and develop a solution. If one changes one's mind, one should add a new comment noting that, rather than editing a prior comment. If the initial description is no longer accurate, file a new issue, close the initial issue as "won't fix" and link it to the new issue.

I've noted this before in the HowToContribute page:

http://wiki.apache.org/lucene-hadoop/HowToContribute#head-374ea7eb0d41f1e7ea5d4c14102d993c494ac90c

Similarly, there is no need to remove stale attachments. These provide history and are useful.

Thanks,

Doug

Reply via email to