Governance
Governance
Who owns this, how it changes, and what is authoritative when docs disagree.
Ownership
- Owner: Daniel (Founder) — voice and strategic messaging
- Editor: Product — glossary and organizer nav labels
- Enforcement: Engineering — design system voice rules in PR review
Source of truth hierarchy
- Component-enforceable rules: design-system.sportingscouter.com/voice (from
ui/VOICE.md) - Writing and channel rules: this site (content-style-guide.sportingscouter.com)
- Brand personality and visual identity:
docs/BRAND_GUIDELINES.mdv2.0 - Cursor agent summary:
.cursor/skills/content-design-system/SKILL.md— generated; site + voice win on conflict
Boundary with design system
If a rule can be expressed in a component API or failed in a PR line comment, it belongs in ui/VOICE.md. If it is voice, glossary, marketing, legal, or translation workflow, it belongs here. This guide links to voice rules — never restates or contradicts them.
Change process
- Propose change (issue or PR to styleguide content)
- Review: product + engineering if i18n keys or glossary terms change
- Update glossary and all four locale files when terms change
- Regenerate Cursor skill from site content
- Version bump in
scripts/nav.mjsSITE.version when shipping substantive releases
Versioning
Content style guide uses semver-style labels (v1.0). Breaking glossary changes require a migration note for in-flight translations.
Visibility
v1.0 is public and indexable. Sitemap: /sitemap.xml. Submit https://content-style-guide.sportingscouter.com/sitemap.xml in Google Search Console after deploy.
Related sites
- design-system.sportingscouter.com — visual design system
- Mailchimp Content Style Guide — structural reference
Sporting Scouter Content Style Guide
Component-enforceable rules: design-system.sportingscouter.com/voice. Tokens from
packages/config/tailwind/theme.css.