🩹 [Patch]: Render group overview pages as section landing pages

[Marius Storhaug (MariusStorhaug)]

Module documentation now renders a command group's overview page as that group's section landing page — the content shown when the group is selected in the navigation — instead of a separate page nested under it. This is delivered by bumping the Document-PSModule action, and the behavior is documented in the repository and module-source structure guidance.

• Fixes Publish group overview pages as the section index instead of a nested sub-page #371

Changed: Group overview pages are the section landing page

Bumped PSModule/Document-PSModule to v1.0.18 in Build-Docs.yml. v1.0.18 publishes a group's overview page as the section index (/Functions/<Group>/) rather than a page nested under the group. Authors can name the overview after its folder (<Category>/<Category>.md) or provide <Category>/index.md directly; either becomes the section landing page.

Changed: Documentation

Documented the behavior in README.md: added a bullet under the repository expectations and updated the Category.md annotation in the module source-structure tree.

Technical Details

• .github/workflows/Build-Docs.yml: Document-PSModule@fb5d349 # v1.0.17 -> @349090c # v1.0.18.
• main already carries v1.0.17 (install built modules at their real version) from 🚀 [Feature]: Plan job decides version before build so tested artifact equals published artifact #342; this PR advances the pin to v1.0.18, which delivers the section-index behavior.
• The site config already enables navigation.indexes, so no mkdocs.yml change is required.

[Copilot]

Pull request overview

Updates this repository’s docs build pipeline to use PSModule/Document-PSModule v1.0.18, enabling command-group overview markdown (<Group>/<Group>.md or <Group>/index.md) to render as the group’s section landing page (MkDocs section index) rather than as a nested page. The README is updated to document the new behavior and recommended module source structure expectations.

Changes:

• Bump PSModule/Document-PSModule GitHub Action from v1.0.16 to v1.0.18 in the docs workflow.
• Document that <Category>/<Category>.md (or <Category>/index.md) becomes the section landing page in the generated docs.
• Update the module source-structure tree annotation to reflect the new landing-page behavior.

Reviewed changes

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

File	Description
README.md	Documents the new “group overview as section landing page” behavior and updates the source-structure guidance accordingly.
.github/workflows/Build-Docs.yml	Updates the pinned PSModule/Document-PSModule action SHA to v1.0.18 to deliver the new rendering behavior.

---

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

[github-actions]

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	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

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

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