Governance · Governance
Governance

Governance

Who owns what, how to version changes, and known drift between this document and shipped surfaces.

Three-site ownership

SiteOwnsURL
Brand guidelines (this site)Foundation, audience, voice, messaging, applicationsbrand-guidelines.sportingscouter.com
Design systemTokens, components, logo mechanics, colour, typography, accessibilitydesign-system.sportingscouter.com
Content style guideGrammar, UI microcopy, errors, email mechanics, glossarycontent-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

  1. Edit brand-guidelines/BRAND_GUIDELINES.md (source of record).
  2. Update the matching src/pages/*.html fragment(s).
  3. Bump SITE.version if the change is material.
  4. Run npm run build and 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.

Topicv2.1 brand docShipped surface
TypographyInter Tight + Geist Mono on marketing surfaces and reportspackages/config/tailwind/theme.css sets DM Sans; design system and content style guide render in DM Sans
Voice pillarsFour 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 copyContent 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