⚙️ [Maintenance]: PowerShell guidance scripts are centrally available

[Marius Storhaug (MariusStorhaug)]

Maintainers can now find the published PowerShell guidance examples alongside Process-PSModule, giving the framework a single maintained home for the scripts that explain common implementation patterns.

New: Published PowerShell guidance scripts

The repository now carries the complete current set of guidance scripts for collections, strings, call stacks, pipeline execution, module loading, file access, and web calls. The published documentation includes the purpose of every script and links directly to the tracked directory. These are reference examples; run an individual script only when its scenario is appropriate for the local environment.

---

Technical details

-Imported the 14 current guidance/ Git blobs from PSModule/docs without changing their contents and verified every imported blob ID against the source repository.
-Added a scoped .gitattributes rule so the imported source stays LF-normalized in Git on Windows checkouts.
-Added the guidance-script reference page, Reference landing-page entry, and site navigation entry. guidance/ remains outside src/ because these scripts are framework reference assets, not Process-PSModule module source; no manifest wiring is required.
-Implementation plan progress: source import and published discoverability are complete.
-Issue convergence sweep: searched open guidance-related issues. PSModule/Process-PSModule#423 is related documentation-consolidation context but is not fully satisfied by this import; no issue is closed.
-Strict documentation validation exposes 28 pre-existing migrated-link warnings outside this diff; the normal build generates the new guidance page successfully. The bounded follow-up is PSModule/Process-PSModule#509.

Changed surface	Standards checked	Framework docs checked	Result
guidance/** (PowerShell)	PowerShell syntax parsing, source fidelity	Repository layout and module source layout	Aligned
docs/content/**, docs/zensical.toml	Markdown structure and navigation	Documentation publishing	Aligned; strict baseline tracked in #509
.gitattributes	Repository text normalization	Repository standard	Aligned

Relevant issues (or links)

-No scoped delivery issue was provided; this import was requested directly.
-#423
-#509

[github-actions]

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
CSS	Pass ✅
CSS_PRETTIER	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