Add docs governance and Czech parity updates
Some checks failed
Docs Check / lint-and-links (push) Has been cancelled
Docs Check / translation-parity (push) Has been cancelled

This commit is contained in:
2026-03-26 17:12:39 +01:00
parent 74d4838480
commit 9ee5acfa4f
29 changed files with 2153 additions and 64 deletions

12
.github/CODEOWNERS vendored Normal file
View File

@@ -0,0 +1,12 @@
# Default owner for repository-wide changes.
* tomas.kracmar@cqre.net
# Canonical charter and doctrinal governance texts.
/docs/en/charter/** tomas.kracmar@cqre.net
/docs/cs/charter/** tomas.kracmar@cqre.net
# License and governance-critical repository policy.
/LICENSE.md tomas.kracmar@cqre.net
/GOVERNANCE.md tomas.kracmar@cqre.net
/CONTRIBUTING.md tomas.kracmar@cqre.net

6
.github/ISSUE_TEMPLATE/config.yml vendored Normal file
View File

@@ -0,0 +1,6 @@
blank_issues_enabled: false
contact_links:
- name: Contribution Guidelines
url: https://git.cqre.net/kosmo/Church-of-Kosmo/src/branch/main/CONTRIBUTING.md
about: Read contribution and tone/style expectations before opening an issue.

53
.github/ISSUE_TEMPLATE/docs_update.yml vendored Normal file
View File

@@ -0,0 +1,53 @@
name: Docs Update
description: Propose documentation, governance, or repository process changes.
title: "docs: "
labels:
- documentation
body:
- type: markdown
attributes:
value: |
Use this template for repository docs/process updates (non-translation specific).
- type: dropdown
id: area
attributes:
label: Area
options:
- Governance
- Contribution process
- Readme/structure
- License clarification
- CI/docs tooling
- Other
validations:
required: true
- type: textarea
id: problem
attributes:
label: Problem / Goal
description: What should improve and why?
validations:
required: true
- type: textarea
id: proposal
attributes:
label: Proposed Change
description: Concrete proposal (files, sections, expected behavior).
validations:
required: true
- type: textarea
id: impact
attributes:
label: Impact
description: Who is affected and how?
placeholder: Contributors, translators, maintainers, external reusers.
- type: checkboxes
id: checks
attributes:
label: Validation
options:
- label: I listed specific files/sections to change.
required: true
- label: I considered compatibility with current charter/codex wording.
required: true

View File

@@ -0,0 +1,60 @@
name: Translation Update
description: Propose or track translation work for language parity.
title: "translation: "
labels:
- translation
body:
- type: markdown
attributes:
value: |
Use this template for translation additions, corrections, and parity alignment.
- type: input
id: source_file
attributes:
label: Source File (Canonical)
description: Path in docs/en
placeholder: docs/en/codex/book2_balance.md
validations:
required: true
- type: input
id: target_file
attributes:
label: Target File (Translation)
description: Path in docs/cs
placeholder: docs/cs/codex/book2_balance.md
validations:
required: true
- type: dropdown
id: change_type
attributes:
label: Translation Change Type
options:
- New translation draft
- Parity alignment
- Terminology correction
- Style/voice refinement
validations:
required: true
- type: textarea
id: scope
attributes:
label: Scope
description: What sections are in scope?
placeholder: Sections 1-4, closing benediction, table labels.
validations:
required: true
- type: textarea
id: notes
attributes:
label: Terminology/Localization Notes
description: Note intentional localization choices or terms needing consensus.
- type: checkboxes
id: checks
attributes:
label: Validation
options:
- label: I checked that structure and section ordering remain aligned where expected.
required: true
- label: I checked that no translation placeholder TODO text remains in the affected file(s).
required: true

29
.github/pull_request_template.md vendored Normal file
View File

@@ -0,0 +1,29 @@
# Pull Request
## Summary
Describe what changed and why.
## Type of Change
- [ ] Translation update
- [ ] Canonical content update
- [ ] Formatting/link cleanup
- [ ] Governance/process update
- [ ] Other (describe in summary)
## Checklist
- [ ] Linked issue (required for material charter/codex/ethics changes)
- [ ] Local markdown links validated (`./scripts/check_markdown_links.sh`)
- [ ] Translation parity checked (`./scripts/translation_parity_report.sh`)
- [ ] Files preserve structure/section order where translation parity is expected
- [ ] Intentional localization differences are explained (if any)
## Affected Files
List key paths changed in this PR.
## Notes for Reviewers
Call out anything that needs focused review (wording, doctrine interpretation, terminology, etc.).

42
.github/workflows/docs-check.yml vendored Normal file
View File

@@ -0,0 +1,42 @@
name: Docs Check
on:
pull_request:
push:
branches:
- main
jobs:
lint-and-links:
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Markdown lint
uses: DavidAnson/markdownlint-cli2-action@v20
with:
globs: |
**/*.md
- name: Validate local markdown links
run: ./scripts/check_markdown_links.sh
translation-parity:
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Build translation parity report
run: ./scripts/translation_parity_report.sh parity-report.md
- name: Publish report to step summary
run: cat parity-report.md >> "$GITHUB_STEP_SUMMARY"
- name: Upload parity report artifact
uses: actions/upload-artifact@v4
with:
name: translation-parity-report
path: parity-report.md