Commit 2a3da6c
fix(docs): README back-links + real LICENSE section (unblocks 2 red CI gates) (#677)
## Problem
README failed **two** CI doc-governance gates (both in
`.github/workflows/ci.yml`):
1. **`check-soundness-ledger.sh`** (property 2, back-links) — README
pointed at `SOUNDNESS-LEDGER.adoc`, a filename that **does not exist**.
The gate greps for `SOUNDNESS.adoc`; the old string didn't match → RED.
2. **`check-doc-truthing.sh`** (DOC-04) — README did **not** mention the
authoritative status matrix `CAPABILITY-MATRIX.adoc` anywhere → RED.
Both were pre-existing reds on `main` (verified against pristine
`origin/main`).
## Fix (README.adoc only)
- Repoint the 3 soundness-ledger references → `docs/SOUNDNESS.adoc`
- Add `docs/CAPABILITY-MATRIX.adoc` (feature readiness) in Status +
Documentation
- Replace the stale *"state the license and add a LICENSE file"* TODO
with a real License section (`LICENSE` + `LICENSES/` already exist:
MPL-2.0 code, CC-BY-SA-4.0 docs)
## Verification (real toolchain — dune 3.24.0, OCaml 4.14.1 + opam)
```
BUILD_EXIT=0
OK: doc-truthing intact — presence invariants + over-claim ratchet (DOC-04/05/08/09). (TRUTH_EXIT=0)
OK: soundness ledger — all 5 properties hold. (GATE_EXIT=0)
```
## Supersedes #675
#675 fixed only the soundness link, so it could not turn the
doc-truthing gate green on its own (that gate is required, so #675 was
unmergeable alone). This PR fixes both. **#675 will be closed as
superseded.** Also unblocks the descriptiles migration #676 (blocked
only by these same README gates).
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>1 parent 255c0b4 commit 2a3da6c
1 file changed
Lines changed: 9 additions & 4 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
27 | 27 | | |
28 | 28 | | |
29 | 29 | | |
30 | | - | |
| 30 | + | |
| 31 | + | |
31 | 32 | | |
32 | 33 | | |
33 | 34 | | |
| |||
142 | 143 | | |
143 | 144 | | |
144 | 145 | | |
145 | | - | |
| 146 | + | |
146 | 147 | | |
147 | 148 | | |
148 | 149 | | |
| |||
192 | 193 | | |
193 | 194 | | |
194 | 195 | | |
195 | | - | |
| 196 | + | |
| 197 | + | |
196 | 198 | | |
197 | 199 | | |
198 | 200 | | |
199 | | - | |
| 201 | + | |
| 202 | + | |
| 203 | + | |
| 204 | + | |
0 commit comments