Commit 4e57601
committed
docs(adr): a code block inside a record is a specimen, not an example
Ruling A on objectui#8363 (director seat, decision batch #88, 2026-09-08)
lands as text.
CONTRIBUTING.md's `docs/` paragraph now states the convention once: a code
block inside an ADR or a dated audit is a SPECIMEN of what was decided or
measured, fenced `plaintext` — an unhighlighted spelling
check-doc-fence-languages.mjs already lists and check-doc-snippet-types.mjs
does not compile — never ts/tsx/typescript. Code a reader may copy stays in
content/docs/** and skills/objectui/**, where a gate compiles it.
The UNGATED_DOCS header comment in check-doc-snippet-types.mjs annotates the
four ledgered rows as the terminal state: no record is edited to make it
compile, no row is deleted to clear the ledger, and new records carry the
convention instead so the list does not grow.
Both edits are additive text. No record is edited, no ledger row is added,
removed or reworded, and no gate behaviour moves.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HxLw5aKDPR5RJgyUR7Exkd1 parent 32f1008 commit 4e57601
2 files changed
Lines changed: 13 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
425 | 425 | | |
426 | 426 | | |
427 | 427 | | |
| 428 | + | |
| 429 | + | |
428 | 430 | | |
429 | 431 | | |
430 | 432 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
917 | 917 | | |
918 | 918 | | |
919 | 919 | | |
| 920 | + | |
| 921 | + | |
| 922 | + | |
| 923 | + | |
| 924 | + | |
| 925 | + | |
| 926 | + | |
| 927 | + | |
| 928 | + | |
| 929 | + | |
| 930 | + | |
920 | 931 | | |
921 | 932 | | |
922 | 933 | | |
| |||
0 commit comments