-
Notifications
You must be signed in to change notification settings - Fork 0
📖 [Docs]: Community defaults aligned with MSX baseline #75
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Marius Storhaug (MariusStorhaug)
merged 11 commits into
main
from
docs/74-community-defaults
Aug 29, 2026
Merged
Changes from all commits
Commits
Show all changes
11 commits
Select commit
Hold shift + click to select a range
cc3e7ae
Align repository governance baseline
MariusStorhaug 99d8351
Align community health guidance
MariusStorhaug 9094701
Use a valid repository code owner
MariusStorhaug bf8041a
Remove unavailable private profile references
MariusStorhaug 28d02e6
Use PSModule community contacts
MariusStorhaug 135dcd0
Match generic repository file defaults
MariusStorhaug 1a40628
Keep repository context evergreen
MariusStorhaug 3b4e46e
Normalize Contributor Covenant spacing
MariusStorhaug f8f80e6
Document initiative agent plugins
MariusStorhaug b398513
Remove repository-level license
MariusStorhaug 9827943
Route agents to repository context
MariusStorhaug File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| @../AGENTS.md |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,15 +1,11 @@ | ||
| # Needed for publishing of examples, build worker defaults to core.autocrlf=input. | ||
| * text eol=autocrlf | ||
| * text=auto eol=lf | ||
|
|
||
| *.mof text eol=crlf | ||
| *.sh text eol=lf | ||
| *.svg eol=lf | ||
| *.bat text eol=crlf | ||
| *.cmd text eol=crlf | ||
|
|
||
| # Ensure any exe files are treated as binary | ||
| *.exe binary | ||
| *.gif binary | ||
| *.ico binary | ||
| *.jpeg binary | ||
| *.jpg binary | ||
| *.xl* binary | ||
| *.pfx binary | ||
| *.pdf binary | ||
| *.png binary | ||
| *.dll binary | ||
| *.so binary |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,50 +1 @@ | ||
| # https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners | ||
| # Each line is a file pattern followed by one or more owners. | ||
|
|
||
| # These owners will be the default owners for everything in | ||
| # the repo. Unless a later match takes precedence, | ||
| # @global-owner1 and @global-owner2 will be requested for | ||
| # review when someone opens a pull request. | ||
| * @PSModule/module-maintainers | ||
|
|
||
| # Order is important; the last matching pattern takes the most | ||
| # precedence. When someone opens a pull request that only | ||
| # modifies JS files, only @js-owner and not the global | ||
| # owner(s) will be requested for a review. | ||
| # *.js @js-owner | ||
|
|
||
| # You can also use email addresses if you prefer. They'll be | ||
| # used to look up users just like we do for commit author | ||
| # emails. | ||
| # *.go docs@example.com | ||
|
|
||
| # Teams can be specified as code owners as well. Teams should | ||
| # be identified in the format @org/team-name. Teams must have | ||
| # explicit write access to the repository. In this example, | ||
| # the octocats team in the octo-org organization owns all .txt files. | ||
| # *.txt @octo-org/octocats | ||
|
|
||
| # In this example, @doctocat owns any files in the build/logs | ||
| # directory at the root of the repository and any of its | ||
| # subdirectories. | ||
| # /build/logs/ @doctocat | ||
|
|
||
| # The `docs/*` pattern will match files like | ||
| # `docs/getting-started.md` but not further nested files like | ||
| # `docs/build-app/troubleshooting.md`. | ||
| # docs/* docs@example.com | ||
|
|
||
| # In this example, @octocat owns any file in an apps directory | ||
| # anywhere in your repository. | ||
| # apps/ @octocat | ||
|
|
||
| # In this example, @doctocat owns any file in the `/docs` | ||
| # directory in the root of your repository and any of its | ||
| # subdirectories. | ||
| # /docs/ @doctocat | ||
|
|
||
| # In this example, @octocat owns any file in the `/apps` | ||
| # directory in the root of your repository except for the `/apps/github` | ||
| # subdirectory, as its owners are left empty. | ||
| # /apps/ @octocat | ||
| # /apps/github | ||
| * @MariusStorhaug | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,45 +1,38 @@ | ||
| <!-- | ||
| https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors | ||
| --> | ||
|
|
||
| # Welcome to PSModule contributing guide | ||
|
|
||
| Thank you for investing your time in contributing to this project! | ||
|
|
||
| Before you get started, please review the following guidelines: | ||
| Read our [Code of Conduct](./CODE_OF_CONDUCT.md) to keep our community approachable and respectable. | ||
|
|
||
| In this guide you will get an overview of the contribution workflow from opening an issue to get your contribution published. | ||
|
|
||
| ## New contributors | ||
|
|
||
| To get an overview of the project, read the [PSModule readme](../profile/README.md). | ||
|
|
||
| Here are some resources to help you get started with open source contributions: | ||
|
|
||
| - [Finding ways to contribute to open source on GitHub](https://docs.github.com/get-started/exploring-projects-on-github/finding-ways-to-contribute-to-open-source-on-github) | ||
| - [Set up Git](https://docs.github.com/get-started/quickstart/set-up-git) | ||
| - [GitHub flow](https://docs.github.com/get-started/quickstart/github-flow) | ||
| - [Collaborating with pull requests](https://docs.github.com/github/collaborating-with-pull-requests) | ||
|
|
||
| ## Contribution guidelines | ||
|
|
||
|  | ||
|
|
||
| 1. Open an issue or indicate that you want any of the open issues, so others know what you are working on. | ||
| 1. Fork the repository. | ||
| 1. Create a branch from `main` and make your changes. | ||
| 1. Write the tests showing the desired functionality first. | ||
| 1. Write the code that makes the tests pass. | ||
| 1. Open a pull request towards `upstream/main` as a draft. | ||
| - Add any details using the PR template. | ||
| - Link the PR to the issue you opened by adding `- Fixes #<issue_number>` so that the issue gets associated and closed with the PR. | ||
| 1. **Review your own PR first!** When you are happy with it, mark it as "Ready for review". | ||
| 1. Review and address comments on your pull request. | ||
| - We do not want to close PRs directly if we disagree on a specific approach. Lets discuss it instead. We are happy to help you with your changes if there are some difficult points in the code or framework. | ||
| - Update your branch with the latest changes from `upstream/main` before your PR is merged. | ||
| 1. Once your pull request is approved, it will be merged and a new feature will be released immediately. | ||
|
|
||
| > [!IMPORTANT] | ||
| > In rare occation we might create a release branch and do a release from that branch, but that is more for bigger changes. | ||
| > These branches might also run with a prerelease tag, so that we can test the changes before we release it to the public. | ||
| # 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. |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.