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 constraintssrc/deck-templates/is subject to the system layersrc/page-templates/is subject to the system and deck layerssrc/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.