📖 [Docs]: Add "Infusing GitHub with PowerShell" solutions page

[Marius Storhaug (MariusStorhaug)]

Summary

Adds a new Solutions collection page, Infusing GitHub with PowerShell, that frames the PSModule initiative around the org mission (infuse GitHub with PowerShell): it describes what the initiative has built and the GitHub platform capabilities we still want to make PowerShell-native.

What's on the page

• What we have — the collection as two halves: the reusable PowerShell modules (grouped by theme) and the GitHub Actions that automate the module delivery lifecycle (grouped by stage), linking to the auto-generated Modules and Actions inventories.
• What we hope to do with it — the parity goal and a build-vs-advocate operating split.
• GitHub capabilities to PowerShell-infuse — Dependabot (no PowerShell Gallery / .psd1 awareness), linting/testing beyond super-linter and MegaLinter via Invoke-ScriptAnalyzer + Invoke-Pester, the GitHub module as "Octokit for PowerShell", and GitHub-Script as a PowerShell-flavored actions/github-script.
• Other gaps — setup-powershell, dependency graph/SBOM, the GitHub Advisory Database, CodeQL, OIDC trusted publishing, GitHub Packages registry, build provenance, and module caching.
• Parity table — capability × mainstream-language support × PowerShell today × PSModule piece or gap.
• Where to take this — what we can build ourselves vs. what needs platform advocacy.

Platform claims are grounded against current GitHub docs (Dependabot, CodeQL, and the Advisory Database all have no PowerShell/PSGallery ecosystem).

Changes

• src/docs/Solutions/Infusing-GitHub-with-PowerShell.md (new page)
• src/zensical.toml (nav entry under Solutions)

Validation

• markdownlint with the repo config: 0 errors
• zensical build --clean (Python 3.13, same as CI): succeeds; the page renders with all sections and its nav entry and internal links resolve

[github-actions]

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITHUB_ACTIONS_ZIZMOR	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
HTML	Pass ✅
JAVASCRIPT_ES	Pass ✅
JAVASCRIPT_PRETTIER	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Pass ✅
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

[Copilot]

Pull request overview

Adds a new Solutions documentation page that frames the PSModule organization’s “infuse GitHub with PowerShell” mission, describing both what’s already been built (modules + Actions) and the remaining GitHub platform gaps where PowerShell parity still needs either tooling or vendor advocacy.

Changes:

• Adds a new Solutions page: “Infusing GitHub with PowerShell”, covering current PSModule assets and parity gaps (Dependabot, code scanning/SARIF, SDK parity, workflow scripting, etc.).
• Adds the new page to the Solutions navigation in zensical.toml.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
src/zensical.toml	Adds the new Solutions page to the site navigation.
src/docs/Solutions/Infusing-GitHub-with-PowerShell.md	New Solutions collection page documenting the PSModule initiative, inventories, and PowerShell parity roadmap on GitHub.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.