From 2bf279c93bbd4d5d26fa2ba8a821ac3211952a16 Mon Sep 17 00:00:00 2001
From: TEC <git@tecosaur.net>
Date: Thu, 9 May 2024 19:09:31 +0800
Subject: [PATCH] Add label categorisation

---
 src/issues.md | 203 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 203 insertions(+)

diff --git a/src/issues.md b/src/issues.md
index f63e1db..6becac5 100644
--- a/src/issues.md
+++ b/src/issues.md
@@ -4,4 +4,207 @@
 
 # GitHub labels
 
+## Status
+
+`status:X` labels indicates where the issue/PR is situated in its lifecycle, and
+any actions that need to be taken regarding it.
+
+### Prompts for action
+
+- `awaiting review`
+- `help wanted`
+- `merge me`
+- `needs compat annotation`
+- `needs decision`
+- `needs docs`
+- `needs more info`
+- `needs nanosoldier run`
+- `needs news`
+- `needs pkgeval`
+- `needs tests`
+- `waiting for author`
+
+### Calls for help
+
+- `MWE wanted`
+- `bisect wanted`
+- `forget me not`
+- `priority`
+- `rr trace wanted`
+- `triage`
+
+### Other
+
+- `DO NOT MERGE`
+
+## Kind
+
+The general nature of the issue/PR
+
+### General kinds
+
+- `breaking`
+- `experimental`
+- `feature`
+- `invalid`
+- `julep`
+- `minor change`
+- `regression`
+- `spam`
+- `speculative`
+- `upstream`
+
+### Kinds of bugs
+
+- `bug`
+- `bugfix`
+- `embarassing bugfix`
+- `heisenbug`
+- `correctness bug`
+- `asan trophy case`
+- `kernel bug`
+
+### Issue specific kinds
+
+- `duplicate`
+- `good first issue`
+- `potential benchmark`
+- `rr trace included`
+
+### PR specific kinds
+
+- `deprecation`
+- `don't squash`
+- `excision`
+- `re-land`
+- `revert`
+
+## Systems
+
+`system:X` labels indicate the nature of the system the issue/PR pertains to,
+whether that be the hardware architecture or operating system. 
+
+- `apple silicon rosetta`
+- `apple silicon`
+- `arm`
+- `freebsd`
+- `linux`
+- `mac`
+- `MS-DOS`
+- `powerpc`
+- `riscv`
+- `windows`
+- `wine`
+- `x86`
+
+## Domains
+
+`domain:X` labels indicate broad areas of the Julia codebase that aren't
+contained to a single module.
+
+- `arrays:sparse`
+- `arrays`
+- `artifacts`
+- `bignums`
+- `broadcast`
+- `building`
+- `ci`, continuous integration
+- `cmd`, calling of external programs
+- `code coverage`
+- `collections`, data structures holding multiple items
+- `complex`, complex numbers
+- `dates`, the `Dates` stdlib and anything else date/time related
+- `display and printing`
+- `docs`
+- `embedding`
+- `equality`
+- `error handling`
+- `error messages`
+- `ffi`
+- `filesystem`
+- `float16`
+- `fold`
+- `gpu`
+- `hashing`
+- `io`
+- `iteration`
+- `linear algebra`
+- `maths`
+- `missing data`
+- `multithreading`
+- `packages`
+- `parallelism`
+- `randomness`
+- `ranges`
+- `rationals`
+- `search & find`
+- `sorting`
+- `statistics`
+- `strings`
+- `tooling`
+- `types and dispatch`
+- `unicode`
+
+## Compiler
+
+- `codegen`
+- `effects`
+- `inference`
+- `interpreter`
+- `latency`
+- `llvm`
+- `lowering`
+- `musl`
+- `optimizer`
+- `plugins`
+- `precompilation`
+- `simd`
+- `traits`
+- `wasm`
+
+## Stdlibs
+
+- `JLLs`
+- `REPL`
+- `TOML`
+- `markdown`
+
+## Uncategorised
+
+- `GC`
+- `Hacktoberfest`
+- `build`
+- `caching`
+- `error messages`
+- `existential crisis`
+- `libgit2` (stdlib or something else?)
+- `logging` (stdlib or more general?)
+- `macros` (compiler? domain?)
+- `modules` (domain? syntax?)
+- `mysys2` (delete?)
+- `observability`
+- `parser`
+- `performance`
+- `pkgimage`
+- `profiler`
+- `release`
+- `security`
+- `semantic conflict`
+- `sockets` (stdlib or more general?)
+- `test` (sdlib vs tests of Julia itself)
+- `testsystem`
+
+We also have the family of backport/version related labels.
+
+## Rare/obselete labels
+
+Labels that should probably be removed or repurposed, based on either the exitance of better labels or rare usage.
+
+- `domain:artifacts`: rarely used
+- `existential crisis`: merge into general "!?!?"-label
+- `linalg triage`: only 5 labels, fold into `triage`?
+- `mysys2`: only 2 labels
+- `semtantic conflict`: only 1 label
+- `release`: only 3 labels
+
 # Triage team