From c679b9340c40d63301e58fc7f625a4ae1322c7ca Mon Sep 17 00:00:00 2001
From: Jessica Schilling <jessica@protocol.ai>
Date: Tue, 31 Mar 2020 14:21:56 -0600
Subject: [PATCH] Update ISSUE-LABELLING.md
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

See https://github.com/protocol/ipfs-dev-exp/issues/3#issuecomment-606779352 and following comments for discussion surrounding this, if it's not obvious enough from the changes themselves. 😊
---
 ISSUE-LABELLING.md | 34 +++++++++++++++++++++-------------
 1 file changed, 21 insertions(+), 13 deletions(-)

diff --git a/ISSUE-LABELLING.md b/ISSUE-LABELLING.md
index 955027f..5ea613c 100644
--- a/ISSUE-LABELLING.md
+++ b/ISSUE-LABELLING.md
@@ -9,6 +9,7 @@
 
 
 - [Motivation](#motivation)
+- [Global labels](#global-labels)
 - [Descriptive labels](#descriptive-labels)
   - [Functional area (`area/`)](#functional-area-area)
   - [Component (`comp/`)](#component-comp)
@@ -19,7 +20,7 @@
   - [Topic (`topic/`)](#topic-topic)
 - [Execution labels](#execution-labels)
   - [Priority (`Pn`)](#priority-pn)
-  - [Hints/advisories (`hint/`)](#hintsadvisories-hint)
+  - [Need (`need/`)](#need-need)
   - [Status (`status/`)](#status-status)
 - [Implementation plan](#implementation-plan)
 - [Inspiration](#inspiration)
@@ -56,6 +57,15 @@ features and changes in total inter-alignment. We are convinced that by creating
 a cohesive and seamless experience across libp2p implementations, we'll unlock
 tremendous value for our beloved downstream users and developers.
 
+## Global labels
+
+These labels are an exception to the taxonomy below, but for a good reason: they
+are often searched by new contributors looking to get initially involved in a 
+project, and are default across GitHub. (See [GitHub help](https://help.github.com/en/github/building-a-strong-community/encouraging-helpful-contributions-to-your-project-with-labels) for details.)
+
+* help wanted
+* good first issue
+
 ## Descriptive labels
 
 These labels describe some aspect of the issue itself. They can generally be set
@@ -185,22 +195,20 @@ maintainers.
 * P2: Medium.
 * P3: Low.
 
-### Hints/advisories (`hint/`)
+### Need (`need/`)
 
 > Surfaces observations and facts about issues, facilitating progress to be
 > made.
 
-* hint/good-first-issue
-* hint/needs-contributor
-* hint/needs-participation
-* hint/needs-decision
-* hint/needs-triage
-* hint/needs-analysis
-* hint/needs-author-input
-* hint/needs-team-input
-* hint/needs-community-input
-* hint/needs-review
-* hint/needs-help
+* need/contributor
+* need/participation
+* need/decision
+* need/triage
+* need/analysis
+* need/author-input
+* need/team-input
+* need/community-input
+* need/review
 
 ### Status (`status/`)