Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "SWT/Devel/Triage"

< SWT‎ | Devel
m
m
Line 1: Line 1:
 
== Triage Process Overview ==
 
== Triage Process Overview ==
The goal of "Triage" is a '''quick''' initial response to incoming bug submissions from users.<br> The intend is for users to receive initial feedback on their submission and for bugs to be categorized properly.<br>
+
The goal of "Triage" is a '''quick''' initial response to incoming bug submissions from users.<br> The intend is for users to receive initial feedback on their submission and for bugs to be categorized properly.
  
* Check for duplicate bugs
+
If the bug has sufficient information, then add the "'''Triaged'''" Keyword to it and optionally leave some message for the user e.g "Thank you for bug submission, we should investigate". The bug status should remain "NEW" and remain assigned to platform-swt-inbox@eclipse.org.  
* Set/update meta data correctly
+
* Link to relevant bugs
+
* Briefly investigate if bug is real (i.e, reproducible on latest master)
+
* Ask user to test with newer version if reported version is very old
+
* Request versions of SWT/OS/java
+
* Request a snippet (or clear steps to reproduce) if it's not clear as to how to reproduce issue
+
* Ping/CC developers involved in related issue (especially when regressions occur)
+
* [Optionally] try to bisect codebase for regression reports
+
 
+
If the bug has sufficient information, then add the "'''Triaged'''" Keyword to it and optionally leave some message for the user e.g "Thank you for bug submission, we should investigate". The bug status should remain "NEW" and it should not be re-assigned to legacy "swt-triage@" user. (see history).
+
  
 
Subsequently, when we look for new bugs to work on, we can check bugs that have the "Triaged" keyword (See queries below). <br>
 
Subsequently, when we look for new bugs to work on, we can check bugs that have the "Triaged" keyword (See queries below). <br>
Line 26: Line 16:
 
<br>
 
<br>
 
<br>
 
<br>
 +
 +
As a swt developer, consider [https://devzing.com/blog/index.php/bugzilla-tip-have-bugzilla-email-me-when-another-person-is-assigned-a-bug/ watching] platform-swt-inbox@eclipse.org in bugzilla, to get notifications about new and triaged bugs.
 +
 +
=== Triage checklist ===
 +
Use the following as a guidline on how to triage a bug:
 +
 +
* Check for duplicate bugs
 +
* Set/update meta data correctly
 +
* Link to relevant bugs
 +
* Briefly investigate if bug is real (i.e, reproducible on latest master)
 +
* Ask user to test with newer version if reported version is very old
 +
* Request versions of SWT/OS/java
 +
* Request a snippet (or clear steps to reproduce) if it's not clear as to how to reproduce issue
 +
* Ping/CC developers involved in related issue (especially when regressions occur)
 +
* [Optionally] try to bisect codebase for regression reports
  
 
=== Setting proper Meta data ===
 
=== Setting proper Meta data ===

Revision as of 17:30, 19 June 2017

Triage Process Overview

The goal of "Triage" is a quick initial response to incoming bug submissions from users.
The intend is for users to receive initial feedback on their submission and for bugs to be categorized properly.

If the bug has sufficient information, then add the "Triaged" Keyword to it and optionally leave some message for the user e.g "Thank you for bug submission, we should investigate". The bug status should remain "NEW" and remain assigned to platform-swt-inbox@eclipse.org.

Subsequently, when we look for new bugs to work on, we can check bugs that have the "Triaged" keyword (See queries below).
When you take ownership of the bug (i.e you intend to work on the bug), you can assign it to yourself. When you start working on the bug, you can set the status to "ASSIGNED".

See the following diagram:

Platform-Triage-Process-v2.png








As a swt developer, consider watching platform-swt-inbox@eclipse.org in bugzilla, to get notifications about new and triaged bugs.

Triage checklist

Use the following as a guidline on how to triage a bug:

  • Check for duplicate bugs
  • Set/update meta data correctly
  • Link to relevant bugs
  • Briefly investigate if bug is real (i.e, reproducible on latest master)
  • Ask user to test with newer version if reported version is very old
  • Request versions of SWT/OS/java
  • Request a snippet (or clear steps to reproduce) if it's not clear as to how to reproduce issue
  • Ping/CC developers involved in related issue (especially when regressions occur)
  • [Optionally] try to bisect codebase for regression reports

Setting proper Meta data

  • For severity and priority, see: WTP/Conventions_of_bug_priority_and_severity.
    • Set appropriate priority. In general we leave severity as set by user, but we can adjust it also. Ex for enhancements set "enhancement".
  • Prefix OS and Component to bug summary.
    • OS: [gtk][gtk2][gtk3][Wayland][Cocoa][Win32]
    • Component: [PI][Graphics][Theme][Accessibility][Printing][DND][Clipboard][OpenGL][Browser][StylepdText][Layout][Examples][Snippets][JUnit][64][I18N][AWT][HiDpi][Custom widgets][Bidi]
    • Note(PI means Native library interface. 64 means 32/64 bit issues. I18N means Internationalization issues).
    • ex: [gtk3][Theme] Button background not styled.
  • Prefix regressions with [Regression]
  • Set appropriate target milestone if we plan to fix it within a particular time frame. You should check with a developer first thou.


Triage Bugzilla Queries

New Bugs

Triaged bugs

Query Construction

To construct the queries above:

Open an incognito browser. (so that everything is hard-coded into url)

Use quick search. For example:

  •  :swt @platform-swt-inbox@eclipse.org -!Triaged
  •  :swt @platform-swt-inbox@eclipse.org -!Triaged os:All,Linux,CentOS -os:Windows
  • etc..

Columns were changed, such that the following were kept:

  • Product, Component, Priority, Severity, Votes, Status, Whiteboard, Target Milestone, Summary, OS, Changed, Opened, Keywords, Tags, Reporter, Version, # of comments
  • "Stagger Headers" was used.

Then result was sorted in desired order: Priority, Votes, Severity, Target Milestone

URL was copied.

History

In the past, triaged bugs were re-assigned from a platform-swt-inbox@eclipse.org to a stw-triaged@eclipse.org user. Instead we now just add the "Triage" keyword.

In the distant past, bugs were assigned to component owners, but that lead to component owners to have large amount of bugs that they did not actually work on.

Some projects used to use platform-inbox, but to mark a bug as triaged, the "ASSIGNED" status was used. But this could lead to confusion where users could think that

Back to the top