Skip to content

Governance

Ownership Model

  • Shared design core (src/shared/) is centrally managed.
  • Company identity artifacts for typography, logos, and naming live in src/shared/design-system/.
  • Header, footer, and content-area allocation standards live in src/shared/design-system/.
  • Page templates and blocks are maintainer-reviewed primitives.
  • Deck templates and deck depot content are collaborative.

Edit Boundaries

  • Content creators: src/page-templates/, src/blocks/, src/deck-templates/, src/deck-depot/, docs/.
  • Maintainers only: src/shared/.

Review Policy

  • New block or template additions require:
  • Registry entry.
  • Example props.
  • Documentation update.

  • Published decks in depot are versioned. Do not overwrite existing published variants.

Standard Override Precedence

When multiple standards affect the same rendered result, precedence is:

system > deck > page > block

Interpretation:

  • src/shared/ defines non-negotiable system-wide constraints
  • src/deck-templates/ is subject to the system layer
  • src/page-templates/ is subject to the system and deck layers
  • src/blocks/ is subject to the system, deck, and page layers

Lower layers should consume higher-layer standards and operate within their constraints, not silently override them.

See: - CONTRIBUTING.md - .github/CODEOWNERS

CI Audit Policy

  • This repo may keep company identity artifacts self-contained for practical delivery work.
  • Those artifacts should still be periodically audited against broader OVES corporate imaging and naming conventions.
  • If repo-local branding diverges from accepted company-wide CI, the shared system-wide artifacts should be updated first, then dependent deck standards should inherit the correction.