diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index cce6638..9ff7064 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -1,36 +1,4 @@ # 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 guidance in the central [MSX documentation](https://msx.no/docs/) +when contributing to this repo. 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..9309d8b 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. + +The central [MSX documentation](https://msx.no/docs/) is the source for MSX +standards and ways of working.