Label Bugs

The highest priority is getting unlabeled bugs to zero.

How to Label a Bug

Change the Title

Most issues have pretty bad titles, hindering future searches. If needed, edit the issue title to align better with the Preferred Issue Titles format.

If you can't figure out from the issue report what the title should be, then you'll definitely need clarification from the user (see "Needs More Info" below).

Add a Label

Classify the bug accordingly:

Duplicate: Many issues are duplicates, so try to find an original
- 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
It's not clear what the issue is describing
- Add the Needs More Info label
- Add a comment explaining why the issue isn't actionable yet
Issue is in external component (e.g. tslint, awesome-typescript-loader, etc)
- Add the External label
- Explain why
Completely useless
- If the issue is completely unsalvageable (e.g. it's just "Why can TypeScript not for C# now?" with no other info), add the Unactionable label and Close.
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

User documentation

News

Debugging TypeScript

Contributing to TypeScript

Building Tools for TypeScript

FAQs

The Main Repo

Want to contribute to this Wiki?

Fork it and send a pull request.