Bump Document-PSModule to v1.0.18; document group section index pages

Build-Docs now uses Document-PSModule v1.0.18, which publishes a group's overview page (<Group>/<Group>.md or <Group>/index.md) as the section landing page instead of a nested page. Documented in README. Fixes #371.

Author: MariusStorhaug

.github/workflows/Build-Docs.yml

@@ -30,7 +30,7 @@ jobs:
           path: ${{ fromJson(inputs.Settings).WorkingDirectory }}/outputs/module
 
       - name: Document module
-        uses: PSModule/Document-PSModule@dc5b329f840f7803ec02d34a42ee725bca39db5f # v1.0.16
+        uses: PSModule/Document-PSModule@349090c346feca4a7e5f51b6e57278a13ad52657 # v1.0.18
         with:
           Name: ${{ fromJson(inputs.Settings).Name }}
           WorkingDirectory: ${{ fromJson(inputs.Settings).WorkingDirectory }}

README.md

@@ -1065,6 +1065,7 @@ Key expectations:
 - Keep at least one exported function under `src/functions/public/` and corresponding tests in `tests/`.
 - Optional folders (`assemblies`, `formats`, `types`, `variables`, and others) are processed automatically when present.
 - Markdown files in `src/functions/public` subfolders become documentation pages alongside generated help.
+- A group's overview page (`<Category>/<Category>.md` named after the folder, or `<Category>/index.md`) becomes that group's section landing page in the docs navigation.
 - The build step compiles `src/` into a root module file and removes the original project layout from the artifact.
 - Documentation generation mirrors the `src/functions/public` hierarchy so help content always aligns with source.
 
@@ -1093,7 +1094,7 @@ How the module is built.
 │   │   └── public/                         # Public commands documented and tested
 │   │       ├── Category/                   # Optional: organize commands into categories
 │   │       │   ├── Get-CategoryCommand.ps1 # Command file within category
-│   │       │   └── Category.md             # Category overview merged into docs output
+│   │       │   └── Category.md             # Group overview -> section landing page (or index.md)
 │   │       ├── Get-PSModuleTest.ps1        # Example command captured by Microsoft.PowerShell.PlatyPS
 │   │       ├── New-PSModuleTest.ps1        # Example command exported and tested
 │   │       ├── Set-PSModuleTest.ps1        # Example command exported and tested