Development record
2026-08-23 — `abcd site check` excludes `docs/` at the page walk, rather than
2026-08-23 — abcd site check excludes docs/ at the page walk, rather than
teaching the parser to tolerate HTML comments on SSG-authored pages
(iss-2608230838592910's own candidate fix, rejected). Tolerating comments
would admit mkdocs-material output into gates whose rules were written for
generator output — the provenance walk and banned-token gate already exempt
the tree via isComposedSurface, so only the mobile and figure-label gates
would newly run over markup this repo cannot act on. Those pages never
entered the page list on any prior revision either (the parser has always
refused comments), so the exclusion removes no coverage that existed; it
states the boundary the overflow audit already draws. The cost is recorded
honestly in the gate's own scope comment: a green report describes the pages
abcd renders and no others, and docs/ layout stays the SSG's own concern.
Frontmatter
| id | dcn-2608230000000001 |
|---|---|
| type | decision |
| date | 2026-08-23 |
.abcd/work/decisions/dcn-2608230000000001-abcd-site-check-excludes-docs-at-the.md
open on GitHub ↗ · commit history ↗
mentions1
- iss-2608230838592910site check refuses every mkdocs-built docs page: the scanner faults on HTML comments (mkdocs-material templates and the FontAwesome icon licence header emit them), so docs/** never parsed — before de19186 those pages silently dropped out of every gate (the ship-day green was a false green over docs), and after it every page-walking gate is loudly denied. The deploy chain's site-check step will fail the next release. Candidate fix: scope the no-comment parse fault to generator-authored pages (the rule's own rationale is 'the generator emits none'), so docs pages parse with comments tolerated and the other gates regain coverage of them.