Skip to content

Triage Instructions

Ryan Cavanaugh edited this page May 24, 2017 · 3 revisions

Label Bugs

The highest priority is getting unlabeled bugs to zero.

Query: Open Unlabeled Issues

How to Label a Bug

Classify the bug accordingly:

  • Duplicate
    • The plurality of issues are duplicates. Try to find something matching this one
    • If you do, add the Duplicate label and add a comment e.g. "See #1234567"
    • If it's clearly an exact duplicate, Close
    • Optional: If the user would have found this with a trivial search (e.g. searching for the title of their own bug), gently remind them to search before logging new issues
  • Legitimate bug (crash, incorrect behavior, etc.): Add the Bug label
    • Optionally add High Priority if it's an easy-to-hit crash or incorrect emit
    • Optionally add one of the Domain: labels if you'd like to
  • Suggestion
    • Add Suggestion and In Discussion if this is something that can be looked at immediately
    • Add Suggestion, Out of Scope, and close if the suggestion is not something we would ever do (change JS runtime semantics, emit Python, switch to Haskell's type system, etc). Add a comment pointing to the Design Goals Wiki page
    • Add Suggestion, Needs Proposal if something requiring a more formal description is required. Add a comment indicating what's needed
  • Question (the user is explicitly asking for help)
    • Add the Question label
    • Provide an answer if it's easy for you to do so, otherwise point them at Stack Overflow and remind that the issue tracker is not a support forum
    • Close the bug if it's egregiously out of scope (e.g. asking for help getting Angular2 working or whatever)
    • If the question is about the compiler API and you can't answer it immediately, assign to a dev
  • Not a bug
    • Add Working as Intended if the behavior is truly done on purpose, or Design Limitation if it's something we would fix in a perfect world but are unable to do so
    • Post a comment explaining why. Try to reference things from the FAQ if applicable; consider updating the FAQ if you think it's a common question
  • Issue is in external component (e.g. tslint, awesome-typescript-loader, etc)
    • Add the External label
    • Explain why
  • Fallback: Not sure
    • Add "Needs Investigation" label
    • Optional: Post comment with your thoughts (e.g. "Might be a type inference bug, need to investigate")

Investigate

Once there are no new unlabeled bugs, start looking at issues which need investigation: Query: Bugs needing investigation

Clone this wiki locally