<html><head></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div><div>On Jul 11, 2010, at 3:19 PM, Martin v. Löwis wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite"><span class="Apple-style-span" style="border-collapse: separate; font-family: Menlo; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; font-size: medium; "><span class="Apple-style-span" style="font-family: monospace; ">Unfortunately, it's often not clear what the submitter wants: does she<br>want to help, or want to get help? For a bug report, I often post a<br>message "can you provide a patch?", but sometimes, it isn't that clear.<br></span></span></blockquote></div><br><div>Perhaps this is the one area where the biggest advance could be made: a clarification of the workflow.</div><div><br></div><div>My experience with Python issues which have been "triaged" is that everyone who triages tickets has a slightly different idea of who is responsible for the ticket and what they're supposed to do next at every point in the process. Triage, as described on <<a href="http://www.python.org/dev/workflow/">http://www.python.org/dev/workflow/</a>>, emphasizes making sure "that all fields in the issue tracker are properly set", rather than on communicating with the contributor or reporter.</div><div><br></div><div>On Twisted, we try to encourage triagers to focus on communicating the workflow ramifications of what a particular contributor has done. We try to provide a response to the bug reporter or patch submitter that says "thanks, but in order to move this along, you need to go through the following steps" and sometimes even attach a link to the workflow document pointing out exactly where in the process the ticket is now stuck. (At least, that's what we're trying to do.)</div><div><br></div><div>This involves a lot of repeating ourselves in ticket comments, but it's well worth it (and as more of the repetition moves into citing links to documents that have been written to describe aspects of the workflow, it's less onerous).</div><div><br></div><div><<a href="http://www.python.org/dev/workflow/">http://www.python.org/dev/workflow/</a>> describes what the steps are, but it's in a sort of procedural passive voice that doesn't say who is responsible for doing reviews or how to get a list of patches which need to be reviewed or what exactly a third-party non-core-committer reviewer should do to remove the 'Patch review' keyword.</div><div><br></div><div><<a href="http://twistedmatrix.com/trac/wiki/TwistedDevelopment#SubmittingaPatch">http://twistedmatrix.com/trac/wiki/TwistedDevelopment#SubmittingaPatch</a>> and <<a href="http://twistedmatrix.com/trac/wiki/ReviewProcess">http://twistedmatrix.com/trac/wiki/ReviewProcess</a>> meander around a bit, but a while ago we re-worked them so that each section has a specific audience (authors, reviewers, or external patch submitters) and that helped readers understand what they're intended to do.</div><div><br></div><div>Plus, <<a href="http://twistedmatrix.com/trac/report/15">http://twistedmatrix.com/trac/report/15</a>> is a useful resource for core developers with only a little bit of free time to do a review.</div><div><br></div><div>(I'm just offering some suggestions based on what I think has worked, not to hold Twisted up as a paragon of a perfect streamlined process. We still have folks complain about stuck patches, these documents are _far_ from perfect, and there are still some varying opinions about how certain workflow problems should be dealt with and differences in quality of review. Plus, we have far fewer patches to deal with than Python. Nevertheless, the situation used to be worse for us, and these measures seem to have helped.)</div></body></html>