Standardize current Markdown naming and structure checks
Summary¶
Standardized the current documentation naming convention around uppercase hyphenated Markdown filenames and added a current-doc structure audit.
This item intentionally leaves historical provenance filenames in place unless they must be touched for active policy-link correctness.
Completed Work¶
- Renamed the policy entrypoints to
WORKSPACE-POLICY.mdandDOCS-POLICY.md. - Updated workspace and repo references to the new policy path.
- Added
scripts/docs-structure-check.pyfor current-doc filename, heading, navigation, and wide-table checks. - Documented the browser-readable table guidance in
DOCS-POLICY.md. - Added missing navigation entries for
CI-BASELINE.mdandREST-API-ADAPTERS.md.
Validation¶
git diff --checkpython scripts\docs-item-taxonomy-check.pypython scripts\docs-structure-check.pypython scripts\github-roadmap-check.pypython scripts\github-roadmap-check.py --github
Implementation is recorded by the tooling commit that adds this item.