diff --git a/app/core/privacy.py b/app/core/privacy.py
index c81c6c3..4f0087a 100644
--- a/app/core/privacy.py
+++ b/app/core/privacy.py
@@ -9,5 +9,8 @@ def scrub(text: str) -> ScrubbedText:
 
 
 def pseudo_id(snils: str, key: str | None = None) -> str:
-    """HMAC-SHA256(PSEUDO_KEY, normalised SNILS) as 32 hex chars — the token linking identity and clinical DBs."""
+    """HMAC-SHA256(PSEUDO_KEY, normalised SNILS) as 32 hex chars.
+
+    The token is the only link between the identity and clinical databases.
+    """
     raise NotImplementedError
diff --git a/app/core/types.py b/app/core/types.py
index cc85392..98d43a4 100644
--- a/app/core/types.py
+++ b/app/core/types.py
@@ -16,7 +16,10 @@ class RiskLevel(IntEnum):
 
 
 class AlertLevel(IntEnum):
-    """Alert level stored in DB. UI colour is derived (ADR-006): ACUTE=red, HIGH/MODERATE=yellow, INFO=grey."""
+    """Alert level stored in DB.
+
+    UI colour is derived (ADR-006): ACUTE=red, HIGH/MODERATE=yellow, INFO=grey.
+    """
 
     INFO = 0
     MODERATE = 1