Skip to content
Brad Micklea edited this page Aug 8, 2016 · 43 revisions

This page describes how we track issues in the eclipse/che repository.

Popular Queries

Triage and Unprocessed Issue Queries

Issue Triage

Questions for Support

Milestone Status Queries

TODO @bmicklea

Issue Labels

The Eclipse Che project relies heavily on issue labels to communicate status and responsibility. Labels are defined in a separate doc.

Issue Triage

New issues are processed and assigned a label for follow-up by the Triage owner, the Triage owner should try and keep the number of unlabelled issues to a minimum at all times while responsibly labelling each issue. A new Issue Triage owner is assigned each week (there will be a rotating schedule and if the person is in development they will be exempted from development tasks for that week - instead their primary role will be working as a support engineer).

The Issue Triage query contains

  • all open issues or pull requests that...
  • are unlabelled, or are non-blocker bugs...
  • and have no one assigned...
  • and aren’t labeled with a team/... label.

For each issue in the list, the Triage owner will analyze the issue and discuss it as necessary with other members of the team then assign a label to it as follows:

  • Answerable issues > Triage owner should solve and close them.
  • Invalid issues > close them and explain the reason.
  • Duplicate issues > close them and add a comment: "Duplicates {issue link}."
  • General questions > label them with “kind/question”.
  • Docs issues > label with “kind/docs”.
  • Enhancement requests > label them with “kind/enhancement” and assign to one of the team lead or product owners.
  • Technical tasks and to-dos > label them with “kind/task” and assign to one of the team lead or product owners.
  • Bugs > label with "kind/bug" and assign to one of the team lead or product owners. Ensure that bugs adhere to the bug template. Note that the label "severity/blocker" should only be used for bugs assigned to a milestone and only by project committers.

Technical issues assigned to a team lead that do not have a status/... label are considered unprocessed (you can find unprocessed issues queries in the common queries section of this page). To complete them the Team Lead (or optionally Triage owner) must:

  • Assign it the appropriate status/ label and optionally add sprint/current-sprint label and add it to the milestone.
  • Edit the title to improve it (if needed).
  • Follow-up with the author (if needed).

Team Leads should keep their unprocessed backlog as small as possible at all times and try to move issues as quickly as possible to "status/open-for-dev".

Consistent Milestones

To enable planning across repositories, we require that all related Che repositories, such as eclipse/che-parent define identical milestones.

Clone this wiki locally