From 0471c178ca0ddf27b2791640d780cb8eec102e2d Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Thu, 10 Sep 2026 13:19:28 +0200 Subject: [PATCH 1/5] Route defaults through PSModule documentation --- .github/CONTRIBUTING.md | 39 +++------------------------------------ AGENTS.md | 5 ----- README.md | 10 ++++++---- 3 files changed, 9 insertions(+), 45 deletions(-) diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index 0646afb..a499a7c 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -1,38 +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 PSModule and MSX - standards. -- Keep each change focused on one deliverable. - -## Agent plugins - -The [MSX agent plugin marketplace](https://github.com/MSXOrg/docs/tree/main/.github/plugin) -provides shared standards and workflow skills. The -[PSModule process plugin](https://github.com/PSModule/Process-PSModule/tree/main/.github/plugin) -provides initiative-specific guidance for Process-PSModule repositories. - -## 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 [PSModule contribution workflow](https://github.com/PSModule/Process-PSModule/) +for central PSModule documentation and contribution guidance. A repository's +local README and contributing guidance take precedence over this fallback. diff --git a/AGENTS.md b/AGENTS.md index 3e926ad..2ad53dc 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,8 +4,3 @@ Read in this order: 1. `README.md` — what this repository provides and how its defaults are enforced. 2. `.github/CONTRIBUTING.md` — how a change is made and reviewed. -3. [PSModule/Process-PSModule](https://github.com/PSModule/Process-PSModule/) — PSModule process and standards. -4. [MSXOrg/docs](https://github.com/MSXOrg/docs/) — the 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 f8904c8..2db5aa4 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,8 @@ # PSModule community defaults -`PSModule/.github` is GitHub's special public repository for organization-wide -community defaults. GitHub uses these files when a PSModule repository does not -define its own corresponding file. This repository must remain public for the -fallback behavior to work. +`PSModule/.github` is GitHub's special public organization-defaults repository. +GitHub uses its community files when a PSModule repository does not define its +own corresponding file. + +[PSModule/Process-PSModule](https://github.com/PSModule/Process-PSModule/) is +the central source for PSModule standards, agent plugins, and ways of working. From 20e2e3dcec95b6906d2b39f520e53f025fa8d22d Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Thu, 10 Sep 2026 18:43:42 +0200 Subject: [PATCH 2/5] Add central MSX contribution links --- .github/CONTRIBUTING.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index a499a7c..de22957 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -1,5 +1,8 @@ # Contributing -Follow the [PSModule contribution workflow](https://github.com/PSModule/Process-PSModule/) -for central PSModule documentation and contribution guidance. A repository's -local README and contributing guidance take precedence over this fallback. +Follow the central [MSX contribution workflow](https://msx.no/docs/Ways-of-Working/Contribution-Workflow/) +and [MSX Ways of Working](https://msx.no/docs/Ways-of-Working/) for shared +contribution guidance. + +For framework-specific guidance, review the +[Process-PSModule documentation](https://psmodule.io/Process-PSModule/). From 53de6568f5ed166de908623f3d4c4a46ff65a38a Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Thu, 10 Sep 2026 19:25:21 +0200 Subject: [PATCH 3/5] Keep defaults README concise --- README.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/README.md b/README.md index 2db5aa4..0e884f9 100644 --- a/README.md +++ b/README.md @@ -3,6 +3,3 @@ `PSModule/.github` is GitHub's special public organization-defaults repository. GitHub uses its community files when a PSModule repository does not define its own corresponding file. - -[PSModule/Process-PSModule](https://github.com/PSModule/Process-PSModule/) is -the central source for PSModule standards, agent plugins, and ways of working. From 441b30b70b94438e84b35f13ab2873fb6d08afac Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Thu, 10 Sep 2026 19:35:49 +0200 Subject: [PATCH 4/5] Use published MSX documentation URLs --- .github/CONTRIBUTING.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index de22957..8a79733 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -1,8 +1,8 @@ # Contributing -Follow the central [MSX contribution workflow](https://msx.no/docs/Ways-of-Working/Contribution-Workflow/) -and [MSX Ways of Working](https://msx.no/docs/Ways-of-Working/) for shared -contribution guidance. +Follow the central [MSX contribution workflow](https://msxorg.github.io/docs/Ways-of-Working/Contribution-Workflow/) +and [MSX Ways of Working](https://msxorg.github.io/docs/Ways-of-Working/) for +shared contribution guidance. For framework-specific guidance, review the [Process-PSModule documentation](https://psmodule.io/Process-PSModule/). From 9fbd167034c0d36d2a774aca33e6f5ae7d91b514 Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Thu, 10 Sep 2026 19:36:45 +0200 Subject: [PATCH 5/5] Restore intended MSX documentation URLs --- .github/CONTRIBUTING.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index 8a79733..de22957 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -1,8 +1,8 @@ # Contributing -Follow the central [MSX contribution workflow](https://msxorg.github.io/docs/Ways-of-Working/Contribution-Workflow/) -and [MSX Ways of Working](https://msxorg.github.io/docs/Ways-of-Working/) for -shared contribution guidance. +Follow the central [MSX contribution workflow](https://msx.no/docs/Ways-of-Working/Contribution-Workflow/) +and [MSX Ways of Working](https://msx.no/docs/Ways-of-Working/) for shared +contribution guidance. For framework-specific guidance, review the [Process-PSModule documentation](https://psmodule.io/Process-PSModule/).