Add contribution workflow and synopsis

[Gijs Reijn (Gijsreyn)]

PR Summary

For newcomers, it's helpful to understand how they can contribute and run the build.ps1 script. This pull request adds a new section to the CONTRIBUTING.md with additional steps. Also added a SYNOPSIS in the build script with examples + removed the -Verbose parameter and added the [CmdletBinding()] attribute

[Mikey Lombardi (He/Him) (michaeltlombardi)]

Thinking about this a bit more in depth, we probably want to use this information for a contributor's guide - which would require placing the majority of the information in Markdown files in the docs folder - likely docs/contributing.

Then we could independently add documents for testing, building from source, and so on. I don't consider this a blocking concern for this PR, just something to be mindful of.

[Ryan Yates (kilasuit)]

Mikey Lombardi (He/Him) (@michaeltlombardi) I like your thinking as this aligns with how the layout is in https://github.com/PowerShell/PowerShell & makes it easier to maintain docs that may be useful in other repos across across the PowerShell Org (or additional ones too) from a centralised repo in future

Kinda annoying though that as part of common repo layouts everything seems to just be thrown on the floor directly at the repo root, like a messy bedroom 😂 & that UI links to certain docs are hardcoded (atm)

Gijs Reijn (@Gijsreyn) I'd recommend as Mikey suggests and follow the PowerShell repo layout. Especially as we can then make use of features like CODEOWNERS for that whole directory easier and add an issue-template for repo documentation updates like this PR should add to the PowerShell Repo

[Mikey Lombardi (He/Him) (michaeltlombardi)]

Gijs Reijn (@Gijsreyn) - would you mind updating this PR? I'll make an effort to get the updated version fully reviewed by next Monday (at the latest) so we can get this merged.

[Copilot]

🟡 Changes recommended

The workflow contains an unsupported build parameter, mismatched branch names, and broken list formatting.

3 open findings

• Indent ordered-list step bodies and code fences correctly · New
• Branch name mismatch causes git push failure · New
• Documented build.ps1 parameter causes test command failure · New

What changed in this PR

Expands contributor onboarding with a GitHub-based contribution workflow and build/test guidance.

Changes:

• Adds repository setup, branching, testing, and pull-request steps.
• Documents branch synchronization and build options.

File	Description
CONTRIBUTING.md	Adds the contributor workflow and command examples.

🧠 Review effort: Balanced

---

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Gijs Reijn (Gijsreyn)]

Mikey Lombardi (He/Him) (@michaeltlombardi) - I have resolved the merge conflict and made a small modification with the latest changes (after 2025😄).