From 52fbd5be8bdaae0c720e1711e7c18d83ebea1f5c Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Thu, 10 Sep 2026 13:16:25 +0200 Subject: [PATCH 1/4] Route organization defaults to central documentation --- .github/CONTRIBUTING.md | 37 +++---------------------------------- AGENTS.md | 4 ---- README.md | 9 ++++++--- 3 files changed, 9 insertions(+), 41 deletions(-) diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index cce6638..3e778ac 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -1,36 +1,5 @@ # Contributing -The affected repository's README and repository-local contribution guidance -define its build, test, and validation steps. Follow those local instructions -before this organization-wide fallback. - -## Before making a change - -- Review the repository's open issues and use the MSX - [issue process](https://msx.no/docs/Ways-of-Working/Issues/) to propose or - claim substantial work. -- Read the repository's code of conduct and applicable MSX standards. -- Keep each change focused on one deliverable. - -## Agent plugin - -The [MSX agent plugin marketplace](https://github.com/MSXOrg/docs/tree/main/.github/plugin) -provides harnesses with skills that route work to current MSX standards and -workflows. - -## Submit the change - -1. Create a short-lived branch from the repository's default branch. -2. Make the smallest complete change and run the repository's relevant checks. -3. Open a draft pull request and follow the MSX - [PR Format](https://msx.no/docs/Ways-of-Working/PR-Format/). -4. Self-review the diff, request Copilot review explicitly, and address - in-scope feedback. -5. Mark the pull request ready only after it satisfies the repository's review - gate. - -The canonical -[Contribution Workflow](https://msx.no/docs/Ways-of-Working/Contribution-Workflow/) -defines the complete delivery loop. Use the MSX -[Review Etiquette](https://msx.no/docs/Ways-of-Working/Review-Etiquette/) when -giving or responding to feedback. +Follow the central MSX +[Contribution Workflow](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Contribution-Workflow.md) +when contributing to this repository. diff --git a/AGENTS.md b/AGENTS.md index 468e379..08350aa 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,7 +4,3 @@ Read in this order: 1. [README.md](README.md) — what this repository provides and how its defaults are enforced. 2. [.github/CONTRIBUTING.md](.github/CONTRIBUTING.md) — how a change is made and reviewed. -3. [MSXOrg/docs](https://github.com/MSXOrg/docs/) — current MSXOrg organization standards. - -Clone each linked repository locally, keep its configuration local to that -clone, and update it before reading it. diff --git a/README.md b/README.md index e7f6aa7..90d3ee4 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,9 @@ # MSXOrg community defaults `MSXOrg/.github` is GitHub's special public repository for organization-wide -community defaults. GitHub uses these files when an MSX repository does -not define its own corresponding file. This repository must remain public for -the fallback behavior to work. +community defaults. GitHub uses these files when an MSX repository does not +define its own corresponding file. This repository must remain public for the +fallback behavior to work. + +[MSXOrg/docs](https://github.com/MSXOrg/docs) is the source for MSX standards +and ways of working. From 0c48e077228e6f84d4271b5575cc8e9f6b80bd76 Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Thu, 10 Sep 2026 19:42:22 +0200 Subject: [PATCH 2/4] Point contributors to published MSX docs --- .github/CONTRIBUTING.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index 3e778ac..824bdfd 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -1,5 +1,4 @@ # Contributing -Follow the central MSX -[Contribution Workflow](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Contribution-Workflow.md) -when contributing to this repository. +Follow the central [MSX documentation](https://msx.no/docs/) when contributing +to this repository. From 22f1c61f2135e3f8764eae82f4053732b357dca1 Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Thu, 10 Sep 2026 19:43:24 +0200 Subject: [PATCH 3/4] Clarify central documentation guidance --- .github/CONTRIBUTING.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index 824bdfd..9ff7064 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -1,4 +1,4 @@ # Contributing -Follow the central [MSX documentation](https://msx.no/docs/) when contributing -to this repository. +Follow the guidance in the central [MSX documentation](https://msx.no/docs/) +when contributing to this repo. From 1664d1eef29862eb500d668cea924db7be64f1d2 Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Thu, 10 Sep 2026 19:51:03 +0200 Subject: [PATCH 4/4] Link README to published MSX docs --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 90d3ee4..9309d8b 100644 --- a/README.md +++ b/README.md @@ -5,5 +5,5 @@ community defaults. GitHub uses these files when an MSX repository does not define its own corresponding file. This repository must remain public for the fallback behavior to work. -[MSXOrg/docs](https://github.com/MSXOrg/docs) is the source for MSX standards -and ways of working. +The central [MSX documentation](https://msx.no/docs/) is the source for MSX +standards and ways of working.