From fe18dca3d67dffac0338b753e60e2d93882e955b Mon Sep 17 00:00:00 2001
From: Vosjedev <vosje@vosjedev.net>
Date: Tue, 28 Oct 2025 16:54:44 +0100
Subject: Add a terminology table

---
 terminology.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 terminology.md

diff --git a/terminology.md b/terminology.md
new file mode 100644
index 0000000..5580f56
--- /dev/null
+++ b/terminology.md
@@ -0,0 +1,21 @@
+
+General terminology.
+
+# site
+A site hosts trackers (optionally in categories). A site is the root of everything.
+
+# tracker
+A tracker contains bugs. A tracker is the first level in the tree.
+A tracker has a description, and is optionally part of a category.
+
+# bug
+A bug is an item in a tracker. A bug has a subject, a description, a status, a type.  A bug contains emails.
+
+The maximum lenth of the subject is 1024 bytes. The maximum length of the description is 65535 bytes.
+Status is one of: OPEN, CLOSED, UNCONF (unconfirmed), REJECT (rejected/not planned), UPSTRM (upstream issue).
+Type is one of: BUG, DISCUS (discussion), PATCH (automatically given to git patches)
+
+# email
+An email is... well... an email. Nothing more to specify here, you know what an email is I hope.
+
+
-- 
cgit