From 90aaec1c9eee77a0beebece48f460c1424c1c8bd Mon Sep 17 00:00:00 2001
From: Fintan Halpenny <fintan.halpenny@gmail.com>
Date: Wed, 27 May 2026 10:56:53 +0100
Subject: [PATCH] CONTRIBUTING: Add section on issue labels

---
 CONTRIBUTING.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 3cee3862..730b2801 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -20,6 +20,32 @@ commandline argument `--log-level debug`.
 If you start `radicle-node` via `rad node start`, then change the
 invocation to `rad node start -- --log-level debug`.
 
+### Issue Labels
+
+At the moment, only delegates of the `heartwood` repository are allowed to edit
+the labels of an issue.
+You can see who the delegates are by running:
+```
+$ rad inspect --delegates
+```
+
+There is no strict convention on the labeling of our issues, however, we do try
+to follow a loose scheme and have landed on the following set to begin with:
+
+```
+p=<low | medium | high> – priority
+crate=<crate name>,<other crate>
+due=<YYYY-QX>
+cob=<typename>
+good-first-issue
+type=<bug|feature|improvement|refactor|spec|doc>
+release=X.Y.Z
+os=<unix|linux|windows|macos|android|ios|…>
+```
+
+These can be used to search for different families of issues, and we will strive
+to always keep labels up to date on our issue log.
+
 ## Contributing Code
 
 When contributing code, please follow these