Skip to content

Commit af22c47

Browse files
Use canonical documentation instead of PR template files
1 parent 05de7ee commit af22c47

5 files changed

Lines changed: 7 additions & 145 deletions

File tree

‎.github/PULL_REQUEST_TEMPLATE.md‎

Lines changed: 0 additions & 136 deletions
This file was deleted.

‎.github/plugin/psmodule/skills/psmodule-release-note-authoring/SKILL.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ If the repository-relative guide is unavailable from an installed plugin, read i
1515

1616
## Agent-specific contract
1717

18-
- Read the target repository's instructions and PR template before editing its metadata.
18+
- Read the target repository's instructions and linked evergreen documentation before editing PR metadata.
1919
- Apply the guide's authoring and replay checks to the full delivered range.
2020
- Report the edited PR URL, relevant baseline, verified impact, and validation outcomes to the owning session.
2121
- Stop and report when the cited guidance or required source evidence is unavailable; identify the evidence gap.

‎.github/plugin/psmodule/skills/psmodule-v8-upgrade/SKILL.md‎

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,6 @@ The current template's default repository anatomy is:
6767
│ │ ├── .powershell-psscriptanalyzer.psd1
6868
│ │ └── .textlintrc
6969
│ ├── PSModule.yml
70-
│ ├── pull_request_template.md
7170
│ ├── release.yml
7271
│ ├── workflows/
7372
│ └── Process-PSModule.yml
@@ -107,7 +106,7 @@ Treat files and directories as follows:
107106
Preserve its intent and only migrate paths when the framework contract
108107
requires it.
109108
- `.github/PSModule.yml`, linters, Dependabot, CODEOWNERS, release metadata,
110-
pull-request templates, and repository guidance are configuration surfaces.
109+
and repository guidance are configuration surfaces.
111110
Inspect and preserve them independently of the caller workflow.
112111
- `tests/BeforeAll.ps1` and `tests/AfterAll.ps1` are optional root-level
113112
module-local phases, not recursively discovered test files.

‎docs/content/guides/formatting-release-note-prs.md‎

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,10 +14,9 @@ the description as the release notes body. The release name is the resolved vers
1414
`Publish.Module.UsePRTitleAsReleaseName` changes that setting. This guide governs authoring; it does not change the
1515
publisher, version resolver, label mappings, or release-note settings.
1616

17-
Use the [MSX PR format](https://msx.no/docs/Ways-of-Working/PR-Format/) for titles and description structure, and the
18-
[repository template](https://github.com/PSModule/Process-PSModule/blob/main/.github/PULL_REQUEST_TEMPLATE.md) as the
19-
local starting point. The guidance applies to PowerShell modules, reusable workflows, GitHub Actions, libraries,
20-
services, infrastructure modules, and published guidance.
17+
Use the [MSX PR format](https://msx.no/docs/Ways-of-Working/PR-Format/) for titles and description structure.
18+
Write the record directly in the pull request using its in-document examples. The guidance applies to PowerShell
19+
modules, reusable workflows, GitHub Actions, libraries, services, infrastructure modules, and published guidance.
2120

2221
## Release records and evergreen documentation
2322

‎docs/content/reference/repository-standard.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -92,7 +92,6 @@ Module repositories use the PSModule framework layout:
9292
| `.github/linters/` | Linter configuration used by the framework's linting stage, including `.markdown-lint.yml` and `.powershell-psscriptanalyzer.psd1`. |
9393
| `.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. |
9494
| `.github/CODEOWNERS` | Ownership routing for reviews and protected areas. |
95-
| `.github/pull_request_template.md` | Scaffolds audience-first titles and classified results with scoped upgrade instructions and evidence; see [Formatting release-note pull requests](../guides/formatting-release-note-prs.md). |
9695
| `.gitattributes` | Normalizes line endings and declares text/binary handling so the module can be developed and built consistently on Linux, macOS, and Windows. |
9796
| `.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. |
9897
| `src/` | Module source compiled into the shipped artifact. |
@@ -107,6 +106,8 @@ Module repositories use the PSModule framework layout:
107106
| `icon/` | Module icon assets. |
108107

109108
Detailed source layout rules live in [PowerShell module standard](powershell-module-standard.md#repository-layout).
109+
Pull request authoring follows [Formatting release-note pull requests](../guides/formatting-release-note-prs.md),
110+
which applies the canonical [MSX PR format](https://msx.no/docs/Ways-of-Working/PR-Format/).
110111

111112
### Caller workflow and reusable workflow
112113

@@ -155,7 +156,6 @@ Required baseline files for module repositories:
155156
| `CLAUDE.md` | Claude Code entry point that imports `AGENTS.md`. |
156157
| `.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. |
157158
| `.github/CODEOWNERS` | Review routing for source, docs, and GitHub workflow files. |
158-
| `.github/pull_request_template.md` | Scaffolds audience-first titles and classified results with scoped upgrade instructions and evidence; see [Formatting release-note pull requests](../guides/formatting-release-note-prs.md). |
159159
| `.github/PSModule.yml` | Module workflow defaults and overrides. |
160160
| `.gitattributes` | Normalizes line endings and declares text/binary handling so the module can be developed and built consistently on Linux, macOS, and Windows. |
161161
| `.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. |

0 commit comments

Comments
 (0)