You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit d2786d5
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: docs/content/reference/repository-standard.md
+17-2Lines changed: 17 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -112,7 +112,6 @@ Module repositories use the PSModule framework layout:
112
112
|`.github/linters/`| Linter configuration used by the framework's linting stage, including `.markdown-lint.yml` and `.powershell-psscriptanalyzer.psd1`. |
113
113
|`.github/dependabot.yml`| Configures ecosystem-appropriate dependency-update pull requests. For PowerShell module repositories the `github-actions` ecosystem is expected; add any other ecosystems the module actually develops in. |
114
114
|`.github/CODEOWNERS`| Ownership routing for reviews and protected areas. |
115
-
|`.github/pull_request_template.md`| Scaffolds pull requests in the MSX PR Format (PR Manager) style — an icon + change-type + user-facing-outcome title, user-facing description sections, an optional technical-details block, and a related-issues block. |
116
115
|`.gitattributes`| Normalizes line endings and declares text/binary handling so the module can be developed and built consistently on Linux, macOS, and Windows. |
117
116
|`.gitignore`| Ignores files that must never be committed, tailored to the PowerShell-module ecosystem: operating-system files, editor and developer-tooling files, PowerShell and Pester test-harness artifacts, and all local build outputs and files created during build and test. |
118
117
|`src/`| Module source compiled into the shipped artifact. |
@@ -170,7 +169,6 @@ Required baseline files for module repositories:
170
169
|`.github/copilot-instructions.md`| Route to `AGENTS.md` for Copilot surfaces that need their own filename. |
171
170
|`.github/dependabot.yml`| Configures ecosystem-appropriate dependency-update pull requests. For PowerShell module repositories the `github-actions` ecosystem is expected; add any other ecosystems the module actually develops in. |
172
171
|`.github/CODEOWNERS`| Review routing for source, docs, and GitHub workflow files. |
173
-
|`.github/pull_request_template.md`| Scaffolds pull requests in the MSX PR Format (PR Manager) style — an icon + change-type + user-facing-outcome title, user-facing description sections, an optional technical-details block, and a related-issues block. |
174
172
|`.github/PSModule.yml`| Module workflow defaults and overrides. |
175
173
|`.gitattributes`| Normalizes line endings and declares text/binary handling so the module can be developed and built consistently on Linux, macOS, and Windows. |
176
174
|`.gitignore`| Ignores files that must never be committed, tailored to the PowerShell-module ecosystem: operating-system files, editor and developer-tooling files, PowerShell and Pester test-harness artifacts, and all local build outputs and files created during build and test. |
@@ -190,6 +188,23 @@ the PSModule layout. `README.md`, `LICENSE`, and `AGENTS.md` remain at the
190
188
repository root because they are repository entry points rather than community
191
189
health files.
192
190
191
+
## Pull request authoring
192
+
193
+
Use the [canonical MSX PR Format](https://msx.no/docs/Ways-of-Working/PR-Format/)
194
+
to author pull requests. For release-bound changes, follow its release-range-first
195
+
method and keep the complete authored release record in the pull request body.
196
+
197
+
PR-template files are not part of the repository or generated-module baseline.
198
+
Do not create, copy, generate, or distribute them in any PSModule repository,
199
+
`Template-PSModule`, or organization `.github` repositories. Do not rely on a
200
+
central PR-template fallback.
201
+
202
+
This includes root, `docs/`, or `.github/` files such as
203
+
`pull_request_template.md` and entries under `PULL_REQUEST_TEMPLATE/`. Their
204
+
absence is intentional, not missing baseline drift. Report existing files as
205
+
stale drift for a separate removal task; do not restore them from an older
206
+
template snapshot.
207
+
193
208
## Agent onboarding files
194
209
195
210
Every repository must be usable by an agent that has never seen it before, without special configuration. Each repository carries its own agent entry points that point to the authoritative documentation instead of restating it:
0 commit comments