0002. Use the Google developer documentation style guide, enforced with Vale
Status
Accepted
Date
2026-10-01
Context
Diátaxis covers structure, not prose. Google’s technical writing guide has a ready-made Vale package, avoiding custom rules and a larger toolchain.
Decision
Use the Google developer documentation style guide, enforced by Vale’s official Google package on all Markdown. No custom rules.
Consequences
- Configure exceptions in
.vale.ini; code and configuration formatting need separate linters. - CI integration is still needed.