2.6 KiB
2.6 KiB
Governance
Operational governance for the Church of Kosmo repository.
Scope
This document governs how canonical texts are proposed, reviewed, approved, and released across:
docs/en/**(canonical source language)docs/cs/**(translation mirror)LICENSE.mdCONTRIBUTING.mdREADME.mdBACKLOG.md
Decision Model
The project uses a consensus-first model.
- A change is proposed through a pull request.
- Reviewers discuss wording, consistency, ethics, and structure.
- If no unresolved objections remain, the change is considered approved.
Consensus Fallback
If consensus cannot be reached in a reasonable window, use this fallback:
- Mark the PR as
needs-reflection. - Open a focused follow-up issue summarizing the conflict and options.
- Pause merge until one of these outcomes occurs:
- wording is revised to remove objection, or
- the proposal is split into smaller non-contentious changes.
No forced-majority merge for disputed canonical wording.
Canonical vs Translation Policy
- English files in
docs/en/are canonical reference texts. - Czech files in
docs/cs/should remain semantically aligned. - Intentional localization is allowed only when documented in the PR description.
- Translation PRs must preserve structure, section numbering, and key terms unless explicitly justified.
Amendment Flow
For material changes to charter, codex, or ethics text:
- Open an issue first with:
- motivation
- affected files
- expected impact
- Link the issue in the pull request.
- Include a short amendment note in PR body:
- what changed
- why now
- compatibility or interpretation impact
- Require CODEOWNERS review before merge.
Release Cadence
Repository releases follow a docs cadence:
- Patch release (
vX.Y.Z) for typo/format/link-only changes. - Minor release (
vX.Y.0) for approved content updates that do not redefine core principles. - Major release (
vX.0.0) for structural or doctrinal-level updates to canonical texts.
Recommended rhythm:
- Monthly patch/minor tags as needed.
- Quarterly canonical review checkpoint.
- Annual governance review of charter and process documents.
Merge and Branch Rules
- All changes arrive through pull requests.
- Direct pushes to protected branches should be disabled.
- CI checks must pass:
- markdown lint
- local markdown link validation
- translation parity report
Records and Traceability
- Significant decisions should be traceable via linked issue + PR.
- Release notes should summarize canonical text changes by file path.
- Backlog updates should mark completed governance/process milestones.