docs(11.1-07): record gap-closure checks in validation and the README follow-up

- validation map rows 11.1-07-T1 through T5 with the commands that passed
- the README src= todo names the refusal, caption and Sync work left
This commit is contained in:
Jakub Zych
2026-10-01 08:53:11 +02:00
parent 550fa06f91
commit ce5dcec7e4
2 changed files with 8 additions and 1 deletions

View File

@@ -6,3 +6,5 @@ area: summercms.go/modules/*/README.md, internal/docsite
---
Phase 11.1 (D-18) publishes every module README as an `api/<name>` docs page, but its Go code blocks (about 41 across 22 READMEs) are only identifier-checked, not compiled. Move each to an `Example*` or region in the module's `example_test.go` and reference it with `src=`, then drop the README exemption in `internal/docsite` `check_policy.go` so ROADMAP 11.1 SC4 can be widened back to "every Go example in the docs".
Since 11.1-07, checkSnippets refuses `src=` in module READMEs (`readmeSrcMessage`) and fenceAnnotator captions only docs/ pages. Converting README fences means replacing that refusal with checkFences over README pages, captioning their top-level `src=` fences, and extending Sync to README files.