feat(docsite): check, caption and sync src= blocks in module READMEs (quick-261118-qsd)

- checkSnippets compares top-level src= fences of module READMEs like
  docs/ pages; the README src= refusal is gone
- Sync also rewrites drifted src= fences in modules/<name>/README.md,
  still all-or-nothing across pages and READMEs
- fenceAnnotator captions top-level src= fences on every page
- the snippet-readme-src planted violation now plants a drifted README
  fence instead of the old refusal
- utilities.md, README.md and CLAUDE.md describe src= in module READMEs
This commit is contained in:
Jakub Zych
2026-11-18 19:29:36 +01:00
parent 830f305376
commit 721830c502
10 changed files with 180 additions and 46 deletions

View File

@@ -22,7 +22,7 @@ cd examples/hello && go test ./... # separate workspace module, not co
go install ./cmd/summer # the CLI
go test ./cmd/summer -run TestDocsTree # docs checker
summer docs:build --check # docs checker (identifiers, links, anchors, src= snippets, command names)
summer docs:sync # refresh src= code copies in docs/ after changing their source
summer docs:sync # refresh src= code copies in docs/ and module READMEs after changing their source
npm --prefix admin ci
npm --prefix admin run test | test:browser | typecheck | build | dev