Governance
Governance
Who owns what, how to version changes, and known drift between this document and shipped surfaces.
Three-site ownership
| Site | Owns | URL |
|---|---|---|
| Brand guidelines (this site) | Foundation, audience, voice, messaging, applications | brand-guidelines.sportingscouter.com |
| Design system | Tokens, components, logo mechanics, colour, typography, accessibility | design-system.sportingscouter.com |
| Content style guide | Grammar, UI microcopy, errors, email mechanics, glossary | content-style-guide.sportingscouter.com |
Versioning
This site tracks the brand document version in the sidebar (v2.1). When the brand changes materially, bump the version in scripts/nav.mjs (SITE.version), update BRAND_GUIDELINES.md, and update the affected page fragments.
When a piece of work contradicts these guidelines, the work changes or the guidelines get versioned. Nothing in between.
How to propose a change
- Edit
brand-guidelines/BRAND_GUIDELINES.md(source of record). - Update the matching
src/pages/*.htmlfragment(s). - Bump
SITE.versionif the change is material. - Run
npm run buildand deploy.
Known drift register
These contradictions exist between v2.1 and shipped surfaces. They are documented here; none is silently resolved by this site build.
| Topic | v2.1 brand doc | Shipped surface |
|---|---|---|
| Typography | Inter Tight + Geist Mono on marketing surfaces and reports | packages/config/tailwind/theme.css sets DM Sans; design system and content style guide render in DM Sans |
| Voice pillars | Four pillars (Authoritative, Direct, Authentic, Evidence-bound) | Content style guide publishes five, including "Community-minded — organizers and athletes in one trust layer" |
| Retired vocabulary | "Reviews" retired from external copy | Content style guide still uses "reviews" in UI examples ("Review published", "Reply to review") |
Resolving drift requires a coordinated update across the relevant site(s), not a silent edit in one place.
Source files
- Markdown source:
brand-guidelines/BRAND_GUIDELINES.md - Navigation and metadata:
brand-guidelines/scripts/nav.mjs - Page fragments:
brand-guidelines/src/pages/*.html - Deploy:
docs/brand-guidelines/DEPLOY.md
Sporting Scouter Brand Guidelines
Visual identity: design-system.sportingscouter.com/brand. Writing mechanics: content-style-guide.sportingscouter.com.