Verification
Pre-Change Verification
| Check | Status |
|---|---|
Triage scan completed — files needing refactoring identified |
[ ] |
STD-016 reviewed for compliance criteria |
[ ] |
Build passes before starting |
[ ] |
Git clean before starting |
[ ] |
Per-File Verification
After refactoring each file:
| Check | Status |
|---|---|
No monolithic code blocks (>30 lines with multiple unrelated commands) |
[ ] |
No commands in table cells |
[ ] |
Every code block has a |
[ ] |
Every code block has a language hint ( |
[ ] |
Content is unchanged (same commands, same output) |
[ ] |
Build clean |
[ ] |
Final Verification
# No monolithic blocks remaining (blocks > 30 lines with mixed commands)
find docs/modules/ROOT/{partials,examples}/codex/ -name "*.adoc" \
-exec awk '/^\[source,/{n=0; block=1} block{n++} /^----$/ && block{if(n>30) print FILENAME": "n" lines"; block=0}' {} \;
# Review output — some long blocks are legitimate (full scripts)
# No commands in table cells
grep -rn '| `[a-z].*`$' docs/modules/ROOT/{partials,examples}/codex/ --include="*.adoc" | head -20
# Expected: metadata only, no executable commands
# Build clean
make 2>&1 | grep -E "WARN|ERROR"