Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 5 additions & 35 deletions .github/CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,38 +1,8 @@
# 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.
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.

## 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.
For framework-specific guidance, review the
[Process-PSModule documentation](https://psmodule.io/Process-PSModule/).
Comment thread
MariusStorhaug marked this conversation as resolved.
5 changes: 0 additions & 5 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
7 changes: 3 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
# 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.
Comment thread
MariusStorhaug marked this conversation as resolved.