diff --git a/terminology/README.md b/terminology/README.md
index 8b13789..28ea792 100644
--- a/terminology/README.md
+++ b/terminology/README.md
@@ -1 +1,6 @@
+Severity
+Used consistently across UI, alerts, and APIs.
+Values: low, medium, high, critical.
 
+Finding
+Must conform to contracts/finding.json.