Narrow the error-code rule to what it forbids, and name the fence rule instead of quoting it

2026-08-25 15:43:30 +02:00
parent 9ce5946173
commit 5be1bf677a
3 changed files with 8 additions and 4 deletions
@@ -76,7 +76,8 @@ The error surface is a contract too. `ConvertError` is `{ code, message, path }`
 closed list a consumer may switch exhaustively, the message free text, the path the node's position
 from the document root. Adding, removing or renaming a code is breaking, so a milestone meeting a
 new failure cause reuses a code where one fits; the list is complete at `0.1.0`. A code names the
-cause, never the node — `path` and `message` carry that.
+cause; where one cause recurs across node types, one code covers them all and `path` and `message`
+say which.

 ## 9. Release automation