path: root/
diff options
authorJesse Bounds <>2016-08-15 11:57:27 -0700
committerGitHub <>2016-08-15 11:57:27 -0700
commit44163274dcb9e74ec5e77b5b24c88b873003239b (patch)
treefc9ad6c46ebcb4cd3a38dffd6c0e43a730b6e804 /
parent52134eb8fd99527e084c6fc9ec2926057c593d4d (diff)
Update contributing readme
Add section about github label system
Diffstat (limited to '')
1 files changed, 17 insertions, 0 deletions
diff --git a/ b/
index ab1da40592..e222639eb1 100644
--- a/
+++ b/
@@ -18,6 +18,23 @@ If you want to contribute code:
Please note the special instructions for contributing new source code files, asset files, or user-facing strings to the [iOS SDK](platform/ios/ or [macOS SDK](platform/macos/
+### Github Issue Labels
+Our labeling system is
+ - **minimalistic:** Labels' usefulness are inversely proportional to how many we have.
+ - **objective:** Labels should be objective enough that any two people would agree on a labeling decision.
+ - **useful:** Labels should track state or capture semantic meaning that would otherwise be hard to search.
+We have divided our labels into categories to make them easier to use.
+ - platform (purple)
+ - type (blue)
+ - actionable status (red)
+ - non-actionable status (grey)
+ - importance / urgency (green)
+ - topic / project / misc (yellow)
# Code of conduct
Everyone is invited to participate in Mapbox’s open source projects and public discussions: we want to create a welcoming and friendly environment. Harassment of participants or other unethical and unprofessional behavior will not be tolerated in our spaces. The [Contributor Covenant]( applies to all projects under the Mapbox organization and we ask that you please read [the full text](