Move the decisions to docs/decisions.md, indexed in AGENTS.md and linked from the fences they back

2026-09-24 13:41:52 +02:00
parent cbe982f52b
commit 9f00ad039e
14 changed files with 759 additions and 491 deletions
@@ -84,8 +84,8 @@ func linkRefs(root map[string]node) error {
 }

 // linkTemplateRefs binds one template's references against root, refusing one that names the
-// category it sits in: a category is a unit, and a reference back into it describes a draw other
-// than the fields beside it.
+// category it sits in.
+// docs/decisions.md#a-category-never-references-itself-and-a-records-fences-run-at-load
 func linkTemplateRefs(folder []string, path, category string, t *template, root map[string]node) error {
 	names := refTokens(t.format)
 	if len(names) == 0 {