Add docs governance and Czech parity updates
This commit is contained in:
12
.github/CODEOWNERS
vendored
Normal file
12
.github/CODEOWNERS
vendored
Normal 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
6
.github/ISSUE_TEMPLATE/config.yml
vendored
Normal 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
53
.github/ISSUE_TEMPLATE/docs_update.yml
vendored
Normal 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
|
||||
|
||||
60
.github/ISSUE_TEMPLATE/translation_update.yml
vendored
Normal file
60
.github/ISSUE_TEMPLATE/translation_update.yml
vendored
Normal 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
29
.github/pull_request_template.md
vendored
Normal 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
42
.github/workflows/docs-check.yml
vendored
Normal 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
|
||||
|
||||
Reference in New Issue
Block a user