diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md new file mode 100644 index 0000000..435af42 --- /dev/null +++ b/.github/CONTRIBUTING.md @@ -0,0 +1,88 @@ +# Contributing + +Thank you for your interest in contributing! This repository is a +**coordination hub** and a satellite of `hyperpolymath/standards`: it +does not own the K9 contractile specification or governance — those are +pinned from `standards` — but it owns the conformance fixtures, the +membership manifest, and the cross-repo drift CI. Human-readable +documentation lives in the root; machine-readable metadata lives under +`.machine_readable/`. + +## How to Contribute + +We welcome contributions in many forms: + +- **Conformance fixtures:** Add or refine `.k9.ncl` cases under + `conformance/valid/` and `conformance/invalid/` (keep + `conformance/manifest.a2ml` in sync). + +- **Membership:** Propose member additions/removals via + `.machine_readable/descriptiles/ECOSYSTEM.a2ml`, kept in lockstep with + `.gitmodules` and `scripts/check-membership.sh`. + +- **Drift CI & tooling:** Improve `.github/workflows/anchor-drift.yml` + or the helper `scripts/`. + +- **Documentation:** Enhance the docs or the AI manifest. + +- **Bug reports:** File clear, reproducible issues. + +## Getting Started + +1. **Read the AI Manifest:** Start with `0-AI-MANIFEST.a2ml` to + understand the repository structure. + +2. **Initialise members:** Run `scripts/init-submodules.sh` to populate + `members/` (each member is pinned by commit). + +3. **Check membership:** Run `scripts/check-membership.sh` to verify + the manifest, `.gitmodules`, and submodule declarations agree. + +4. **Validate conformance:** Run the K9 validator + (`hyperpolymath/k9-validate-action`) over `conformance/valid` + (expect 0 errors) and over `conformance/invalid` with strict mode + (every case must error). + +## Development Workflow + +### Branch Naming + + docs/short-description # Documentation + test/what-added # Test additions + feat/short-description # New features + fix/issue-number-description # Bug fixes + refactor/what-changed # Code improvements + security/what-fixed # Security fixes + +### Commit Messages + +We follow [Conventional Commits](https://www.conventionalcommits.org/): + + (): + + [optional body] + + [optional footer] + +Types: `feat`, `fix`, `docs`, `test`, `refactor`, `ci`, `chore`, +`security` + +## Reporting Bugs + +Before reporting: 1. Search existing issues 2. Check if it’s already +fixed in `main` + +When reporting, include: - Clear, descriptive title - Environment +details (OS, versions, toolchain) - Steps to reproduce - Expected vs +actual behaviour + +## Code of Conduct + +All contributors are expected to adhere to our [Code of +Conduct](CODE_OF_CONDUCT.md). + +## License + +By contributing, you agree that your contributions will be licensed +under the same licenses as the project: code under MPL-2.0 and +documentation under CC-BY-SA-4.0 (see LICENSE and LICENSES/). diff --git a/CONTRIBUTING.adoc b/CONTRIBUTING.adoc deleted file mode 100644 index 174e1f5..0000000 --- a/CONTRIBUTING.adoc +++ /dev/null @@ -1,86 +0,0 @@ -== Contributing - -Thank you for your interest in contributing! This repository is a -*coordination hub* and a satellite of `+hyperpolymath/standards+`: it -does not own the K9 contractile specification or governance — those are -pinned from `+standards+` — but it owns the conformance fixtures, the -membership manifest, and the cross-repo drift CI. Human-readable -documentation lives in the root; machine-readable metadata lives under -`+.machine_readable/+`. - -=== How to Contribute - -We welcome contributions in many forms: - -* *Conformance fixtures:* Add or refine `+.k9.ncl+` cases under -`+conformance/valid/+` and `+conformance/invalid/+` (keep -`+conformance/manifest.a2ml+` in sync). -* *Membership:* Propose member additions/removals via -`+.machine_readable/descriptiles/ECOSYSTEM.a2ml+`, kept in lockstep with -`+.gitmodules+` and `+scripts/check-membership.sh+`. -* *Drift CI & tooling:* Improve `+.github/workflows/anchor-drift.yml+` -or the helper `+scripts/+`. -* *Documentation:* Enhance the docs or the AI manifest. -* *Bug reports:* File clear, reproducible issues. - -=== Getting Started - -[arabic] -. *Read the AI Manifest:* Start with `+0-AI-MANIFEST.a2ml+` to -understand the repository structure. -. *Initialise members:* Run `+scripts/init-submodules.sh+` to populate -`+members/+` (each member is pinned by commit). -. *Check membership:* Run `+scripts/check-membership.sh+` to verify the -manifest, `+.gitmodules+`, and submodule declarations agree. -. *Validate conformance:* Run the K9 validator -(`+hyperpolymath/k9-validate-action+`) over `+conformance/valid+` -(expect 0 errors) and over `+conformance/invalid+` with strict mode -(every case must error). - -=== Development Workflow - -==== Branch Naming - -.... -docs/short-description # Documentation -test/what-added # Test additions -feat/short-description # New features -fix/issue-number-description # Bug fixes -refactor/what-changed # Code improvements -security/what-fixed # Security fixes -.... - -==== Commit Messages - -We follow https://www.conventionalcommits.org/[Conventional Commits]: - -.... -(): - -[optional body] - -[optional footer] -.... - -Types: `+feat+`, `+fix+`, `+docs+`, `+test+`, `+refactor+`, `+ci+`, -`+chore+`, `+security+` - -=== Reporting Bugs - -Before reporting: 1. Search existing issues 2. Check if it’s already -fixed in `+main+` - -When reporting, include: - Clear, descriptive title - Environment -details (OS, versions, toolchain) - Steps to reproduce - Expected vs -actual behaviour - -=== Code of Conduct - -All contributors are expected to adhere to our -link:CODE_OF_CONDUCT.md[Code of Conduct]. - -=== License - -By contributing, you agree that your contributions will be licensed -under the same licenses as the project: code under MPL-2.0 and -documentation under CC-BY-SA-4.0 (see LICENSE and LICENSES/). diff --git a/deno/.github/workflows/rhodibot.yml b/deno/.github/workflows/rhodibot.yml index 87dcad8..6f9135f 100644 --- a/deno/.github/workflows/rhodibot.yml +++ b/deno/.github/workflows/rhodibot.yml @@ -2,7 +2,7 @@ # rhodibot.yml — Automated RSR compliance enforcement # # Reads root-hygiene rules and auto-fixes what it can: -# - Delete banned files (AI.djot, duplicate CONTRIBUTING.adoc, stale snapshots) +# - Delete banned files (AI.djot, duplicate ../../../.github/CONTRIBUTING.md, stale snapshots) # - Rename misnamed files (AI.a2ml → 0-AI-MANIFEST.a2ml) # - Fix SPDX headers (AGPL → PMPL in dotfiles) # - Create missing required files (SECURITY.md, CONTRIBUTING.md) @@ -68,9 +68,9 @@ jobs: fi # --- 3. Delete duplicate format files --- - if [ -f "CONTRIBUTING.md" ] && [ -f "CONTRIBUTING.adoc" ]; then - rm CONTRIBUTING.adoc - FIXES="$FIXES\n- Deleted duplicate \`CONTRIBUTING.adoc\` (keeping .md for GitHub)" + if [ -f ".github/CONTRIBUTING.md" ] && [ -f "deno/.github/CONTRIBUTING.md" ]; then + rm deno/.github/CONTRIBUTING.md + FIXES="$FIXES\n- Deleted duplicate \`deno/.github/CONTRIBUTING.md\` (keeping \`.github/CONTRIBUTING.md\` for GitHub)" CHANGED=true fi diff --git a/deno/.machine_readable/contractiles/dust/Dustfile.a2ml b/deno/.machine_readable/contractiles/dust/Dustfile.a2ml index be38a8c..2096cab 100644 --- a/deno/.machine_readable/contractiles/dust/Dustfile.a2ml +++ b/deno/.machine_readable/contractiles/dust/Dustfile.a2ml @@ -35,7 +35,7 @@ These are housekeeping items, not blockers. ### no-duplicate-contributing - description: Only one CONTRIBUTING format (keep .md) -- run: "! (test -f CONTRIBUTING.md && test -f CONTRIBUTING.adoc)" +- run: "! (test -f CONTRIBUTING.md && test -f ../.github/CONTRIBUTING.md)" - severity: warning ### no-duplicate-readme diff --git a/deno/0-AI-MANIFEST.a2ml b/deno/0-AI-MANIFEST.a2ml index 8cb4ae8..1ea8052 100644 --- a/deno/0-AI-MANIFEST.a2ml +++ b/deno/0-AI-MANIFEST.a2ml @@ -90,7 +90,7 @@ k9-deno/ ├── 0-AI-MANIFEST.a2ml # THIS FILE (start here) ├── README.adoc # High-level orientation (Rich Human) ├── ROADMAP.adoc # Future direction -├── CONTRIBUTING.adoc # Human contribution guide +├── ../.github/CONTRIBUTING.md # Human contribution guide ├── GOVERNANCE.adoc # Decision-making model ├── Justfile # Task runner ├── Containerfile # OCI build diff --git a/deno/CONTRIBUTING.adoc b/deno/CONTRIBUTING.adoc index a7cf861..e1baa8b 100644 --- a/deno/CONTRIBUTING.adoc +++ b/deno/CONTRIBUTING.adoc @@ -19,7 +19,7 @@ We welcome contributions in many forms: == Contribution Policies -For detailed rules on branch naming, commit messages, and the PR process, please refer to the machine-readable manual at link:.github/CONTRIBUTING.md[CONTRIBUTING.adoc]. +For detailed rules on branch naming, commit messages, and the PR process, please refer to the machine-readable manual at link:../.github/CONTRIBUTING.md[Contributing Guide]. == Code of Conduct diff --git a/editors/vscode/.github/workflows/rhodibot.yml b/editors/vscode/.github/workflows/rhodibot.yml index 87dcad8..f44893f 100644 --- a/editors/vscode/.github/workflows/rhodibot.yml +++ b/editors/vscode/.github/workflows/rhodibot.yml @@ -2,7 +2,7 @@ # rhodibot.yml — Automated RSR compliance enforcement # # Reads root-hygiene rules and auto-fixes what it can: -# - Delete banned files (AI.djot, duplicate CONTRIBUTING.adoc, stale snapshots) +# - Delete banned files (AI.djot, duplicate ../../../../.github/CONTRIBUTING.md, stale snapshots) # - Rename misnamed files (AI.a2ml → 0-AI-MANIFEST.a2ml) # - Fix SPDX headers (AGPL → PMPL in dotfiles) # - Create missing required files (SECURITY.md, CONTRIBUTING.md) @@ -68,9 +68,9 @@ jobs: fi # --- 3. Delete duplicate format files --- - if [ -f "CONTRIBUTING.md" ] && [ -f "CONTRIBUTING.adoc" ]; then - rm CONTRIBUTING.adoc - FIXES="$FIXES\n- Deleted duplicate \`CONTRIBUTING.adoc\` (keeping .md for GitHub)" + if [ -f ".github/CONTRIBUTING.md" ] && [ -f "editors/vscode/.github/CONTRIBUTING.md" ]; then + rm editors/vscode/.github/CONTRIBUTING.md + FIXES="$FIXES\n- Deleted duplicate \`editors/vscode/.github/CONTRIBUTING.md\` (keeping \`.github/CONTRIBUTING.md\` for GitHub)" CHANGED=true fi diff --git a/editors/vscode/.machine_readable/contractiles/dust/Dustfile.a2ml b/editors/vscode/.machine_readable/contractiles/dust/Dustfile.a2ml index be38a8c..71a9755 100644 --- a/editors/vscode/.machine_readable/contractiles/dust/Dustfile.a2ml +++ b/editors/vscode/.machine_readable/contractiles/dust/Dustfile.a2ml @@ -35,7 +35,7 @@ These are housekeeping items, not blockers. ### no-duplicate-contributing - description: Only one CONTRIBUTING format (keep .md) -- run: "! (test -f CONTRIBUTING.md && test -f CONTRIBUTING.adoc)" +- run: "! (test -f CONTRIBUTING.md && test -f ../../.github/CONTRIBUTING.md)" - severity: warning ### no-duplicate-readme diff --git a/editors/vscode/0-AI-MANIFEST.a2ml b/editors/vscode/0-AI-MANIFEST.a2ml index 45cd095..b1978ae 100644 --- a/editors/vscode/0-AI-MANIFEST.a2ml +++ b/editors/vscode/0-AI-MANIFEST.a2ml @@ -90,7 +90,7 @@ This repo follows the **Dual-Track** architecture: ├── 0-AI-MANIFEST.a2ml # THIS FILE (start here) ├── README.adoc # High-level orientation (Rich Human) ├── ROADMAP.adoc # Future direction -├── CONTRIBUTING.adoc # Human contribution guide +├── ../../.github/CONTRIBUTING.md # Human contribution guide ├── GOVERNANCE.adoc # Decision-making model ├── Justfile # Task runner ├── Containerfile # OCI build diff --git a/editors/vscode/CONTRIBUTING.adoc b/editors/vscode/CONTRIBUTING.adoc index a7cf861..7304ffd 100644 --- a/editors/vscode/CONTRIBUTING.adoc +++ b/editors/vscode/CONTRIBUTING.adoc @@ -19,7 +19,7 @@ We welcome contributions in many forms: == Contribution Policies -For detailed rules on branch naming, commit messages, and the PR process, please refer to the machine-readable manual at link:.github/CONTRIBUTING.md[CONTRIBUTING.adoc]. +For detailed rules on branch naming, commit messages, and the PR process, please refer to the machine-readable manual at link:.github/CONTRIBUTING.md[../../.github/CONTRIBUTING.md]. == Code of Conduct diff --git a/gleam/MAINTAINERS.adoc b/gleam/MAINTAINERS.adoc index daf8a78..362fa06 100644 --- a/gleam/MAINTAINERS.adoc +++ b/gleam/MAINTAINERS.adoc @@ -62,4 +62,4 @@ For questions about project governance: * link:GOVERNANCE.adoc[Governance Model] * link:CODE_OF_CONDUCT.md[Code of Conduct] -* link:CONTRIBUTING.adoc[Contributing Guide] +* link:../.github/CONTRIBUTING.md[Contributing Guide] diff --git a/haskell/.github/workflows/rhodibot.yml b/haskell/.github/workflows/rhodibot.yml index 87dcad8..56acc21 100644 --- a/haskell/.github/workflows/rhodibot.yml +++ b/haskell/.github/workflows/rhodibot.yml @@ -2,7 +2,7 @@ # rhodibot.yml — Automated RSR compliance enforcement # # Reads root-hygiene rules and auto-fixes what it can: -# - Delete banned files (AI.djot, duplicate CONTRIBUTING.adoc, stale snapshots) +# - Delete banned files (AI.djot, duplicate ../../../.github/CONTRIBUTING.md, stale snapshots) # - Rename misnamed files (AI.a2ml → 0-AI-MANIFEST.a2ml) # - Fix SPDX headers (AGPL → PMPL in dotfiles) # - Create missing required files (SECURITY.md, CONTRIBUTING.md) @@ -68,9 +68,9 @@ jobs: fi # --- 3. Delete duplicate format files --- - if [ -f "CONTRIBUTING.md" ] && [ -f "CONTRIBUTING.adoc" ]; then - rm CONTRIBUTING.adoc - FIXES="$FIXES\n- Deleted duplicate \`CONTRIBUTING.adoc\` (keeping .md for GitHub)" + if [ -f ".github/CONTRIBUTING.md" ] && [ -f "haskell/.github/CONTRIBUTING.md" ]; then + rm haskell/.github/CONTRIBUTING.md + FIXES="$FIXES\n- Deleted duplicate \`haskell/.github/CONTRIBUTING.md\` (keeping \`.github/CONTRIBUTING.md\` for GitHub)" CHANGED=true fi diff --git a/haskell/.machine_readable/contractiles/dust/Dustfile.a2ml b/haskell/.machine_readable/contractiles/dust/Dustfile.a2ml index be38a8c..2096cab 100644 --- a/haskell/.machine_readable/contractiles/dust/Dustfile.a2ml +++ b/haskell/.machine_readable/contractiles/dust/Dustfile.a2ml @@ -35,7 +35,7 @@ These are housekeeping items, not blockers. ### no-duplicate-contributing - description: Only one CONTRIBUTING format (keep .md) -- run: "! (test -f CONTRIBUTING.md && test -f CONTRIBUTING.adoc)" +- run: "! (test -f CONTRIBUTING.md && test -f ../.github/CONTRIBUTING.md)" - severity: warning ### no-duplicate-readme diff --git a/haskell/0-AI-MANIFEST.a2ml b/haskell/0-AI-MANIFEST.a2ml index 45cd095..da99047 100644 --- a/haskell/0-AI-MANIFEST.a2ml +++ b/haskell/0-AI-MANIFEST.a2ml @@ -90,7 +90,7 @@ This repo follows the **Dual-Track** architecture: ├── 0-AI-MANIFEST.a2ml # THIS FILE (start here) ├── README.adoc # High-level orientation (Rich Human) ├── ROADMAP.adoc # Future direction -├── CONTRIBUTING.adoc # Human contribution guide +├── ../.github/CONTRIBUTING.md # Human contribution guide ├── GOVERNANCE.adoc # Decision-making model ├── Justfile # Task runner ├── Containerfile # OCI build diff --git a/haskell/CONTRIBUTING.adoc b/haskell/CONTRIBUTING.adoc index a7cf861..5dcbad0 100644 --- a/haskell/CONTRIBUTING.adoc +++ b/haskell/CONTRIBUTING.adoc @@ -19,7 +19,7 @@ We welcome contributions in many forms: == Contribution Policies -For detailed rules on branch naming, commit messages, and the PR process, please refer to the machine-readable manual at link:.github/CONTRIBUTING.md[CONTRIBUTING.adoc]. +For detailed rules on branch naming, commit messages, and the PR process, please refer to the machine-readable manual at link:../.github/CONTRIBUTING.md[../.github/CONTRIBUTING.md]. == Code of Conduct diff --git a/haskell/README.adoc b/haskell/README.adoc index 34c0095..e8f19e6 100644 --- a/haskell/README.adoc +++ b/haskell/README.adoc @@ -154,7 +154,7 @@ See link:https://github.com/hyperpolymath/contractiles[contractiles documentatio == Documentation -* link:CONTRIBUTING.adoc[Contributing Guide] +* link:../.github/CONTRIBUTING.md[Contributing Guide] * link:GOVERNANCE.adoc[Governance Model] * link:docs/attribution/MAINTAINERS.adoc[Maintainers & Citations] * link:SECURITY.adoc[Security Policy] diff --git a/haskell/docs/accessibility/README.adoc b/haskell/docs/accessibility/README.adoc index 7415d98..288c8c0 100644 --- a/haskell/docs/accessibility/README.adoc +++ b/haskell/docs/accessibility/README.adoc @@ -243,7 +243,7 @@ Burble is committed to: * Supporting screen readers and other assistive technologies * Continuous improvement based on user feedback -We welcome contributions to improve accessibility. See our link:../CONTRIBUTING.adoc[Contributing Guide] for details. +We welcome contributions to improve accessibility. See our link:../../../.github/CONTRIBUTING.md[Contributing Guide] for details. == Related Documents diff --git a/pandoc/.github/workflows/rhodibot.yml b/pandoc/.github/workflows/rhodibot.yml index 87dcad8..b335b20 100644 --- a/pandoc/.github/workflows/rhodibot.yml +++ b/pandoc/.github/workflows/rhodibot.yml @@ -2,7 +2,7 @@ # rhodibot.yml — Automated RSR compliance enforcement # # Reads root-hygiene rules and auto-fixes what it can: -# - Delete banned files (AI.djot, duplicate CONTRIBUTING.adoc, stale snapshots) +# - Delete banned files (AI.djot, duplicate ../../../.github/CONTRIBUTING.md, stale snapshots) # - Rename misnamed files (AI.a2ml → 0-AI-MANIFEST.a2ml) # - Fix SPDX headers (AGPL → PMPL in dotfiles) # - Create missing required files (SECURITY.md, CONTRIBUTING.md) @@ -68,9 +68,9 @@ jobs: fi # --- 3. Delete duplicate format files --- - if [ -f "CONTRIBUTING.md" ] && [ -f "CONTRIBUTING.adoc" ]; then - rm CONTRIBUTING.adoc - FIXES="$FIXES\n- Deleted duplicate \`CONTRIBUTING.adoc\` (keeping .md for GitHub)" + if [ -f ".github/CONTRIBUTING.md" ] && [ -f "pandoc/.github/CONTRIBUTING.md" ]; then + rm pandoc/.github/CONTRIBUTING.md + FIXES="$FIXES\n- Deleted duplicate \`pandoc/.github/CONTRIBUTING.md\` (keeping \`.github/CONTRIBUTING.md\` for GitHub)" CHANGED=true fi diff --git a/pandoc/.machine_readable/contractiles/dust/Dustfile.a2ml b/pandoc/.machine_readable/contractiles/dust/Dustfile.a2ml index be38a8c..2096cab 100644 --- a/pandoc/.machine_readable/contractiles/dust/Dustfile.a2ml +++ b/pandoc/.machine_readable/contractiles/dust/Dustfile.a2ml @@ -35,7 +35,7 @@ These are housekeeping items, not blockers. ### no-duplicate-contributing - description: Only one CONTRIBUTING format (keep .md) -- run: "! (test -f CONTRIBUTING.md && test -f CONTRIBUTING.adoc)" +- run: "! (test -f CONTRIBUTING.md && test -f ../.github/CONTRIBUTING.md)" - severity: warning ### no-duplicate-readme diff --git a/pandoc/0-AI-MANIFEST.a2ml b/pandoc/0-AI-MANIFEST.a2ml index 45cd095..da99047 100644 --- a/pandoc/0-AI-MANIFEST.a2ml +++ b/pandoc/0-AI-MANIFEST.a2ml @@ -90,7 +90,7 @@ This repo follows the **Dual-Track** architecture: ├── 0-AI-MANIFEST.a2ml # THIS FILE (start here) ├── README.adoc # High-level orientation (Rich Human) ├── ROADMAP.adoc # Future direction -├── CONTRIBUTING.adoc # Human contribution guide +├── ../.github/CONTRIBUTING.md # Human contribution guide ├── GOVERNANCE.adoc # Decision-making model ├── Justfile # Task runner ├── Containerfile # OCI build diff --git a/pandoc/CONTRIBUTING.adoc b/pandoc/CONTRIBUTING.adoc index a7cf861..5dcbad0 100644 --- a/pandoc/CONTRIBUTING.adoc +++ b/pandoc/CONTRIBUTING.adoc @@ -19,7 +19,7 @@ We welcome contributions in many forms: == Contribution Policies -For detailed rules on branch naming, commit messages, and the PR process, please refer to the machine-readable manual at link:.github/CONTRIBUTING.md[CONTRIBUTING.adoc]. +For detailed rules on branch naming, commit messages, and the PR process, please refer to the machine-readable manual at link:../.github/CONTRIBUTING.md[../.github/CONTRIBUTING.md]. == Code of Conduct diff --git a/rs/.github/workflows/rhodibot.yml b/rs/.github/workflows/rhodibot.yml index 87dcad8..1b8b76a 100644 --- a/rs/.github/workflows/rhodibot.yml +++ b/rs/.github/workflows/rhodibot.yml @@ -2,7 +2,7 @@ # rhodibot.yml — Automated RSR compliance enforcement # # Reads root-hygiene rules and auto-fixes what it can: -# - Delete banned files (AI.djot, duplicate CONTRIBUTING.adoc, stale snapshots) +# - Delete banned files (AI.djot, duplicate ../../../.github/CONTRIBUTING.md, stale snapshots) # - Rename misnamed files (AI.a2ml → 0-AI-MANIFEST.a2ml) # - Fix SPDX headers (AGPL → PMPL in dotfiles) # - Create missing required files (SECURITY.md, CONTRIBUTING.md) @@ -68,9 +68,9 @@ jobs: fi # --- 3. Delete duplicate format files --- - if [ -f "CONTRIBUTING.md" ] && [ -f "CONTRIBUTING.adoc" ]; then - rm CONTRIBUTING.adoc - FIXES="$FIXES\n- Deleted duplicate \`CONTRIBUTING.adoc\` (keeping .md for GitHub)" + if [ -f ".github/CONTRIBUTING.md" ] && [ -f "rs/.github/CONTRIBUTING.md" ]; then + rm rs/.github/CONTRIBUTING.md + FIXES="$FIXES\n- Deleted duplicate \`rs/.github/CONTRIBUTING.md\` (keeping \`.github/CONTRIBUTING.md\` for GitHub)" CHANGED=true fi diff --git a/rs/.machine_readable/contractiles/dust/Dustfile.a2ml b/rs/.machine_readable/contractiles/dust/Dustfile.a2ml index be38a8c..2096cab 100644 --- a/rs/.machine_readable/contractiles/dust/Dustfile.a2ml +++ b/rs/.machine_readable/contractiles/dust/Dustfile.a2ml @@ -35,7 +35,7 @@ These are housekeeping items, not blockers. ### no-duplicate-contributing - description: Only one CONTRIBUTING format (keep .md) -- run: "! (test -f CONTRIBUTING.md && test -f CONTRIBUTING.adoc)" +- run: "! (test -f CONTRIBUTING.md && test -f ../.github/CONTRIBUTING.md)" - severity: warning ### no-duplicate-readme diff --git a/rs/0-AI-MANIFEST.a2ml b/rs/0-AI-MANIFEST.a2ml index 45cd095..da99047 100644 --- a/rs/0-AI-MANIFEST.a2ml +++ b/rs/0-AI-MANIFEST.a2ml @@ -90,7 +90,7 @@ This repo follows the **Dual-Track** architecture: ├── 0-AI-MANIFEST.a2ml # THIS FILE (start here) ├── README.adoc # High-level orientation (Rich Human) ├── ROADMAP.adoc # Future direction -├── CONTRIBUTING.adoc # Human contribution guide +├── ../.github/CONTRIBUTING.md # Human contribution guide ├── GOVERNANCE.adoc # Decision-making model ├── Justfile # Task runner ├── Containerfile # OCI build diff --git a/rs/CONTRIBUTING.adoc b/rs/CONTRIBUTING.adoc index a7cf861..5dcbad0 100644 --- a/rs/CONTRIBUTING.adoc +++ b/rs/CONTRIBUTING.adoc @@ -19,7 +19,7 @@ We welcome contributions in many forms: == Contribution Policies -For detailed rules on branch naming, commit messages, and the PR process, please refer to the machine-readable manual at link:.github/CONTRIBUTING.md[CONTRIBUTING.adoc]. +For detailed rules on branch naming, commit messages, and the PR process, please refer to the machine-readable manual at link:../.github/CONTRIBUTING.md[../.github/CONTRIBUTING.md]. == Code of Conduct diff --git a/rs/README.adoc b/rs/README.adoc index 34c0095..e8f19e6 100644 --- a/rs/README.adoc +++ b/rs/README.adoc @@ -154,7 +154,7 @@ See link:https://github.com/hyperpolymath/contractiles[contractiles documentatio == Documentation -* link:CONTRIBUTING.adoc[Contributing Guide] +* link:../.github/CONTRIBUTING.md[Contributing Guide] * link:GOVERNANCE.adoc[Governance Model] * link:docs/attribution/MAINTAINERS.adoc[Maintainers & Citations] * link:SECURITY.adoc[Security Policy] diff --git a/showcase/docs/accessibility/README.adoc b/showcase/docs/accessibility/README.adoc index 7415d98..288c8c0 100644 --- a/showcase/docs/accessibility/README.adoc +++ b/showcase/docs/accessibility/README.adoc @@ -243,7 +243,7 @@ Burble is committed to: * Supporting screen readers and other assistive technologies * Continuous improvement based on user feedback -We welcome contributions to improve accessibility. See our link:../CONTRIBUTING.adoc[Contributing Guide] for details. +We welcome contributions to improve accessibility. See our link:../../../.github/CONTRIBUTING.md[Contributing Guide] for details. == Related Documents diff --git a/tools/README.adoc b/tools/README.adoc index c08b2fa..cdde09c 100644 --- a/tools/README.adoc +++ b/tools/README.adoc @@ -361,7 +361,7 @@ k9-tools/ === Contributing -See link:CONTRIBUTING.adoc[CONTRIBUTING.adoc] for guidelines. +See link:../.github/CONTRIBUTING.md[../.github/CONTRIBUTING.md] for guidelines. == Documentation diff --git a/validate-action/.github/workflows/rhodibot.yml b/validate-action/.github/workflows/rhodibot.yml index 87dcad8..e72344f 100644 --- a/validate-action/.github/workflows/rhodibot.yml +++ b/validate-action/.github/workflows/rhodibot.yml @@ -2,7 +2,7 @@ # rhodibot.yml — Automated RSR compliance enforcement # # Reads root-hygiene rules and auto-fixes what it can: -# - Delete banned files (AI.djot, duplicate CONTRIBUTING.adoc, stale snapshots) +# - Delete banned files (AI.djot, duplicate ../../../.github/CONTRIBUTING.md, stale snapshots) # - Rename misnamed files (AI.a2ml → 0-AI-MANIFEST.a2ml) # - Fix SPDX headers (AGPL → PMPL in dotfiles) # - Create missing required files (SECURITY.md, CONTRIBUTING.md) @@ -68,9 +68,9 @@ jobs: fi # --- 3. Delete duplicate format files --- - if [ -f "CONTRIBUTING.md" ] && [ -f "CONTRIBUTING.adoc" ]; then - rm CONTRIBUTING.adoc - FIXES="$FIXES\n- Deleted duplicate \`CONTRIBUTING.adoc\` (keeping .md for GitHub)" + if [ -f ".github/CONTRIBUTING.md" ] && [ -f "validate-action/.github/CONTRIBUTING.md" ]; then + rm validate-action/.github/CONTRIBUTING.md + FIXES="$FIXES\n- Deleted duplicate \`validate-action/.github/CONTRIBUTING.md\` (keeping \`.github/CONTRIBUTING.md\` for GitHub)" CHANGED=true fi diff --git a/validate-action/.machine_readable/contractiles/dust/Dustfile.a2ml b/validate-action/.machine_readable/contractiles/dust/Dustfile.a2ml index be38a8c..2096cab 100644 --- a/validate-action/.machine_readable/contractiles/dust/Dustfile.a2ml +++ b/validate-action/.machine_readable/contractiles/dust/Dustfile.a2ml @@ -35,7 +35,7 @@ These are housekeeping items, not blockers. ### no-duplicate-contributing - description: Only one CONTRIBUTING format (keep .md) -- run: "! (test -f CONTRIBUTING.md && test -f CONTRIBUTING.adoc)" +- run: "! (test -f CONTRIBUTING.md && test -f ../.github/CONTRIBUTING.md)" - severity: warning ### no-duplicate-readme diff --git a/validate-action/0-AI-MANIFEST.a2ml b/validate-action/0-AI-MANIFEST.a2ml index 4cd31ed..6a0046f 100644 --- a/validate-action/0-AI-MANIFEST.a2ml +++ b/validate-action/0-AI-MANIFEST.a2ml @@ -90,7 +90,7 @@ k9-validate-action/ ├── 0-AI-MANIFEST.a2ml # THIS FILE (start here) ├── README.adoc # High-level orientation (Rich Human) ├── ROADMAP.adoc # Future direction -├── CONTRIBUTING.adoc # Human contribution guide +├── ../.github/CONTRIBUTING.md # Human contribution guide ├── GOVERNANCE.adoc # Decision-making model ├── Justfile # Task runner ├── Containerfile # OCI build diff --git a/validate-action/CONTRIBUTING.adoc b/validate-action/CONTRIBUTING.adoc index a7cf861..5e05eae 100644 --- a/validate-action/CONTRIBUTING.adoc +++ b/validate-action/CONTRIBUTING.adoc @@ -19,7 +19,7 @@ We welcome contributions in many forms: == Contribution Policies -For detailed rules on branch naming, commit messages, and the PR process, please refer to the machine-readable manual at link:.github/CONTRIBUTING.md[CONTRIBUTING.adoc]. +For detailed rules on branch naming, commit messages, and the PR process, please refer to the machine-readable manual at link:.github/CONTRIBUTING.md[../.github/CONTRIBUTING.md]. == Code of Conduct