📖 [Docs]: Contribution and PowerShell guidance made consistent#75
Merged
Marius Storhaug (MariusStorhaug) merged 6 commits intoJul 25, 2026
Merged
Conversation
Copilot started reviewing on behalf of
Marius Storhaug (MariusStorhaug)
July 25, 2026 15:27
View session
There was a problem hiding this comment.
Pull request overview
This PR aligns contributor-facing documentation so repository standards, issue planning guidance, worktree setup, and PowerShell examples no longer give conflicting instructions.
Changes:
- Updates the PR description guidance to match the canonical PR body sequence (user-facing impact/sections first, technical details optional, related issues last).
- Refines issue implementation-plan guidance to keep tests alongside each behavior while still enforcing test-first execution.
- Makes Git worktree examples consistent with required branch naming (
<type>/<issue>-<slug>) while keeping concise local worktree folder names, and updates the PowerShell “skip FunctionCount” example to comply with the PowerShell function standard.
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| src/docs/Ways-of-Working/Repository-Standard.md | Aligns PR description ordering guidance with the standard PR body sequence. |
| src/docs/Ways-of-Working/Issue-Format.md | Clarifies implementation plan organization (behavior-grouped tasks; tests kept with behaviors; test-first still required). |
| src/docs/Ways-of-Working/Git-Worktrees.md | Updates worktree layout and PowerShell commands to separate local folder names from required branch names. |
| src/docs/Frameworks/Process-PSModule/skipping-framework-tests.md | Expands the FunctionCount skip example so every function shown meets the PowerShell function standard (help, OutputType/OUTPUTS, typing/validation, implicit output). |
Marius Storhaug (MariusStorhaug)
marked this pull request as ready for review
July 25, 2026 15:28
Marius Storhaug (MariusStorhaug)
enabled auto-merge (squash)
July 25, 2026 15:28
Marius Storhaug (MariusStorhaug)
marked this pull request as draft
July 25, 2026 16:03
auto-merge was automatically disabled
July 25, 2026 16:03
Pull request was converted to draft
Marius Storhaug (MariusStorhaug)
force-pushed
the
docs-74-consistency-fixes
branch
from
July 25, 2026 16:03
8b00df7 to
4dec4c3
Compare
Copilot started reviewing on behalf of
Marius Storhaug (MariusStorhaug)
July 25, 2026 16:06
View session
Copilot started reviewing on behalf of
Marius Storhaug (MariusStorhaug)
July 25, 2026 16:12
View session
Marius Storhaug (MariusStorhaug)
marked this pull request as ready for review
July 25, 2026 16:14
Marius Storhaug (MariusStorhaug)
enabled auto-merge (squash)
July 25, 2026 16:14
Marius Storhaug (MariusStorhaug)
marked this pull request as draft
July 25, 2026 16:31
auto-merge was automatically disabled
July 25, 2026 16:31
Pull request was converted to draft
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Marius Storhaug (MariusStorhaug)
force-pushed
the
docs-74-consistency-fixes
branch
from
July 25, 2026 16:32
ea7d874 to
cd487a6
Compare
Copilot started reviewing on behalf of
Marius Storhaug (MariusStorhaug)
July 25, 2026 16:35
View session
Marius Storhaug (MariusStorhaug)
marked this pull request as ready for review
July 25, 2026 16:37
Marius Storhaug (MariusStorhaug)
enabled auto-merge (squash)
July 25, 2026 16:37
Marius Storhaug (MariusStorhaug)
marked this pull request as draft
July 25, 2026 16:53
auto-merge was automatically disabled
July 25, 2026 16:53
Pull request was converted to draft
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot started reviewing on behalf of
Marius Storhaug (MariusStorhaug)
July 25, 2026 16:56
View session
Marius Storhaug (MariusStorhaug)
marked this pull request as ready for review
July 25, 2026 16:58
Marius Storhaug (MariusStorhaug)
enabled auto-merge (squash)
July 25, 2026 16:58
Marius Storhaug (MariusStorhaug)
disabled auto-merge
July 25, 2026 17:09
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
Contributors can follow the repository, agent setup, worktree, issue-planning, and PowerShell example guidance without choosing between contradictory instructions.
Changed: Contribution guidance now agrees
<type>/<issue>-<slug>branch names.psmodule.io/<Module>/Functions[/<Group>]/<Function>URL used by PSModule framework commands.Fixed: The FunctionCount skip example follows every remaining rule
Every displayed function now includes complete comment-based help, matching
[OutputType()]and.OUTPUTSmetadata, typed and validated parameters, implicit output, and a.LINKto the public function's generated online reference page. Only the intentionally namedFunctionCountframework test is exempted.Technical Details
Related issues