mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2026-11-06 10:59:59 +00:00
Removes 67 live references to docs/requirements/<NNN>-*.md files across
43 contributor docs, role READMEs, code comments, task files, and tests.
Requirement docs are initial-creation-only artefacts; live references
freeze a snapshot that rots once the per-feature SPOT (a contributor
doc, a code module, a lint test) takes over the live behaviour.
In the same pass, fixes documentation.md violations on the touched
files: drops em-dashes used as thought breaks, removes "SPOT for ..."
self-labels, strips historical phrasing ("the legacy", "previously",
"used to", "is no longer used", "matching the historical"), and
reflows soft-wrapped sentences so each sentence stays on one logical
line.
The `test_inventory_vars_file_spot.py` whitelist for the literal
inventory path drops the docs/requirements/003 entry and instead
skips docs/requirements/ entirely; future requirement docs that
mention the literal path are then ignored automatically.
Verified by tests/lint/repository/test_no_stale_requirement_refs.py
(green tree-wide).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
831 B
831 B
Role meta/variants.yml Tests 🔀
Integration tests that enforce invariants of each role's meta/variants.yml: the matrix-deploy variant list MUST exercise every dynamic flag declared in the role's meta/services.yml on both polarities, every service key referenced under services: in a variant MUST exist in services.yml, and the auth matrix (oidc / oauth2 / ldap) MUST cover the LDAP-only branch.
Tests in this directory MUST only cover meta/variants.yml shape and coverage. Coverage of meta/services.yml itself lives in ../services/; coverage of meta/main.yml's dependencies: key lives in ../dependencies/.
For framework, directory layout, and make test-integration usage see integration.md.