Changes between Version 73 and Version 74 of TracTicketTriage
- Timestamp:
- Jan 12, 2015, 9:42:14 PM (9 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
TracTicketTriage
v73 v74 3 3 This page lists guidelines and conventions used within the Trac project for [http://en.wikipedia.org/wiki/Triage triage] of tickets. 4 4 5 As a matter of fact, we happen to mainly focus on the Milestone information to decide whether a ticket has been triaged or not. Therefore, still to be triaged tickets can be found in queries specifying an unset milestone, likequery:status!=closed&milestone= or report:20.5 We focus on the Milestone information to decide whether a ticket has been triaged or not. Therefore, still to be triaged tickets can be found in queries specifying an unset milestone, such as query:status!=closed&milestone= or report:20. 6 6 7 7 There are currently: 8 8 - [[TicketQuery(status!=closed,milestone=,keywords!~=needinfo,format=count)]] untriaged tickets 9 - [[TicketQuery(status!=closed,keywords~=needinfo,format=count)]] tickets for which we're waiting for feedback10 - [[TicketQuery(status!=closed,milestone!=,format=count)]] valid tickets to work on ...9 - [[TicketQuery(status!=closed,keywords~=needinfo,format=count)]] tickets for which more feedback is required 10 - [[TicketQuery(status!=closed,milestone!=,format=count)]] valid tickets to work on 11 11 12 12 == How to help? == 13 13 14 First, there is a good deal of tickets which are not yet triaged. Anyone with some knowledge about the Trac project can help us to apply the triaging rules, in orderto detect duplicate requests, eliminate invalid tickets and identify the real issues by assigning them a milestone.15 - tickets which are targeting a software which hasnothing to do with Trac should be closed as //invalid// with the **WrongTrac** mention in the comment16 - tickets which are targeting a Trac plugin should be closed as //cantfix// with the **PluginIssue** mention in the comment. If the identity of the plugin is easily determined, add the `TH:<Plugin>` mention.14 Anyone with some knowledge about the Trac project can help us to apply the triaging rules, to detect duplicate requests, eliminate invalid tickets and identify the real issues by assigning them a milestone. 15 - tickets which have nothing to do with Trac should be closed as //invalid// with the **WrongTrac** mention in the comment 16 - tickets regarding a Trac plugin should be closed as //cantfix// with the **PluginIssue** mention in the comment. If the identity of the plugin is easily determined, add the `TH:<Plugin>` mention. 17 17 - if the plugin is "agilo", then mention **AgiloForScrum** and add support@agile42.com to the CC: 18 18 - tickets which are clearly about installation issues or support requests should be invalidated as well, qualifying it as an **InstallationIssue** and directing the reporter to the MailingList. 19 19 - for complaints about the long inactivity on opened tickets, refer to **ThisTicketWasOpenedTenYearsAgo** 20 20 21 For the tickets that are waiting for user feedback, anyone can help as well: close tickets which haven't received the requested feedback since a few months or further process them if they received somefeedback.21 For the tickets that are waiting for user feedback, anyone can help as well: close tickets which haven't received the requested feedback since a few months or further process them if they received feedback. 22 22 23 23 Finally, among the valid tickets, [query:status!=closed&milestone!=&keywords!~=needinfo&type=defect&group=milestone many are categorized as defects]. Those should probably get the most attention or be recategorized as enhancements if they are not real defects. 24 24 25 25 == Milestone == 26 === Dos === 27 26 28 * If resolution is `fixed`, the Milestone should be set accordingly to the RoadMap. See report:36 for tickets that should be corrected one day. 27 29 * If resolution is `duplicate`, `cantfix`, `wontfix`, `invalid` or `worksforme` the Milestone should be blank. See report:35 for tickets that should be corrected. 30 * If the ticket is valid and related to Trac, but no developer is planning to work on it for a next release, use [milestone:unscheduled]. 31 * If the ticket is valid and related to Trac, but not directly related to a release, use [milestone:"not applicable"]. 32 33 === Don'ts === 28 34 29 35 * Don't assign a milestone without a reason or patch. 30 36 * Don't modify a milestone as ''anonymous'' and without a reason. 31 37 * Don't assign a milestone of a bugfix only release (e.g. 0.10.5) to enhancement request tickets. 32 33 * If the ticket is valid and related to Trac, but no developer is planning to work on it for a next release, use [milestone:unscheduled].34 * If the ticket is valid and related to Trac, but not directly related to a release, use [milestone:"not applicable"].35 38 36 39 == Status and Resolution == … … 47 50 - In original request: ''#2345 has been marked as duplicate of this ticket'' 48 51 * We usually let open the ticket which contains the most up-to-the-point discussion about the issue, the one which contains an appropriate patch, or other than that, the oldest ticket. 49 * Finally, if it's the n^th^ time such a duplicate has been created, it's about time tolist it in the ticket duplicates hall of fame, i.e. the MostFrequentDuplicates page.52 * Finally, if it's the n^th^ time such a duplicate has been created, list it in the ticket duplicates hall of fame, i.e. the MostFrequentDuplicates page. 50 53 51 54 And also, don't close or reopen a ticket without a reason. … … 60 63 == Ticket Description == 61 64 62 Only administrators can edit ticket descriptions. 65 Only administrators can edit ticket descriptions. They are only edited to fix formatting errors, not the actual content. Occasionally, we may also add editorial notes, in order to not spread misleading information, e.g. #4297 or to summarize the current status of a long running issue, e.g. #4132 or #2611. In all cases, it should be quite clear from the formatting what's coming from the original author and what has been annotated afterwards. 63 66 64 67 == Keywords == … … 139 142 [kwquery:solaris], 140 143 [kwquery:macosx] 141 - Presentation issues 144 - Presentation issues: 142 145 * [kwquery:layout], issues with the organization of the pages 143 146 * [kwquery:navigation], main and meta navigation issues … … 155 158 [kwquery:safari], 156 159 [kwquery:chrome] 157 - Other kinds of grouping 160 - Other kinds of grouping: 158 161 * [kwquery:crash] -- There's a segmentation fault or other serious OS level error implied. 159 162 * [kwquery:memory] -- Out of memory condition, most probably involving memory leaks. … … 172 175 * ''eblot'': Following the update Matt did on #4222, I think we also need to document what is / would be the policy for outdated Trac releases (criteria to declare as wontfix, etc.) 173 176 174 175 177 '''Policy for closing tickets''' 176 178 … … 180 182 * Avoid closing tickets without a comment of the reporter 181 183 * This is especially true if the reporter is an active contributor 182 * be open minded, and accept that the exist ent processes have some deficits (for sure there are documentation deficits, that's why this document was initiated)[comment:ticket:4174:15 see #4174]184 * be open minded, and accept that the existing processes have some deficiencies [comment:ticket:4174:15 see #4174] 183 185 * core developers have final authority to close tickets