blob: c2965ede51cc6908379941f2e74e39a77a2afdb9 [file] [log] [blame]
#summary For discussions about the issue tracker
#labels Importance-Useful,Phase-Guidelines,Contents-Draft
= Introduction =
Here's the place to discuss ways to improve our use of the issue tracker. We also use this page to capture information that we've wanted to shoe horn into the issue tracker but haven't yet been able to.
= General Tips =
* When adding a new issue to the issue tracker, [,Duplicate&sort=-id search all issues], not just the open issues to see if it has been reported before. There can be a lag between an issue being fixed and it being deployed in a running version of Melange.
* When merging issues, you may need to change the title summary of the issue. Generally *don't be shy of changing the title of an issue* to make it clearer to someone reading the list what the issue is about.
* *Merging:* Most often we merge new (duplicate) issues into older issues.
* If you want to change the status or title of an issue and don't have the edit-rights to do so, ask on our IRC channel, #melange.
= Canned Searches =
_See also the specific tags for searches for those tags_
|| [ AJaxy Table] || An issue into which many component issues have been merged ||
|| [ The 1000 records issue] || A limitation with GAE that needs a workaround ||
|| [ Due date] || Issues sorted by due date ||
= Issue Tracker Activities _(Terminology)_ =
* *Triage:* Deciding what needs to happen for ALL live issues in the tracker.
* *Cherry Picking:* Going through fixing and closing trivial issues (i.e. quick to fix issues) so that they do not clutter up the tracker. Often leads to trivial issues changing status (e.g. to !NeedInfo ).
* *Dredging:* Going through issues which are 6 months+ old, checking they are still valid, ensuring there is some policy in place so that they don't clog up the tracker. Check for example that old issues which are not live have milestone 'future'. 'Dredging' can also be used for learning from closed issues, for example a spate of related invalid issues may indicate a need for some documentation changes.
= !NeedInfo Status =
* It is very easy for an issue to get 'stuck' in !NeedsInfo status. When changing an issue to !NeedsInfo status, it is a good idea to in the comment say what information is needed, so that it is easy to assess whether the issue is still in that status after a number of comments have arrived.
Search for *[ NeedInfo Issues]*
= Special Tags and Statuses =
* *[ Verbiage]:* This item is a change in wording and if it also has the tag '!NeedsInfo' then likely it needs a decision on the wording to progress.
* *[ Security]:* At least some part of this issue is security related. If a security issue is given a low priority some explanation about why it's not something to worry about will usually be given in the comments.
* *[ Can't Fix]:* We won't fix this issue because it's not possible to. This tag rarely survives long and there currently are just three 'Cant Fix' tags in the tracker.
* *[ WikiDiscuss]:* Conversation has been taken to the wiki. If no link is given in the issue tracker comments then visit page [WikiDiscuss].
* *[ DueBy-YEAR-MONTH-DAY]:* Date by which developer with issue assigned intends to have fix committed to mainline.
* *[ PatchReceived]:* This issue has had a patch submitted. The patch is under review per these guidelines (taken from [MeetingAgendasNotes 27 April Team Meeting Notes])
==Patch Reviews==
We want to get a lot *better about reviewing and committing patches*. Right now we are not doing this well enough. New strategy:
# We quickly sync within 24 hours about who is going to review a patch.
# All patches will be ack'ed within 48 hours, which means that we say at least "hey thanks we got your patch." Person ack'ing the patch is the person who will review it.
# Patch will be reviewed and feedback sent to submitter and relevant issue in the tracker updated within 5 days (read: 120 hours).
_Add suggestions for new tags and statuses here..._
=Issue Tracker Stats=
||Date||[ PatchReceived]||[ Security]||[ Verbiage]||[ NeedInfo]||[ CantFix]||
||2009-May-02|| 3 || 5 || 3 || 4 || 3 ||
||2009-May-21|| 0 || 4 || 3 || 4 || 3 ||
= Related Pages =
* [TestingGuidelines]
* [PendingUserStories]
* [WikiDiscuss]