⚙️ [Maintenance]: Authored Functions landing pages stay published

[Marius Storhaug (MariusStorhaug)]

Modules can carry an authored src/functions/public/index.md that becomes the top-level Functions landing page in the generated documentation, giving readers a stable introduction before they drill into grouped commands.

Changed: Authored Functions landing pages stay published

An authored root Functions page is preserved in the generated documentation artifact as outputs/docs/index.md, so it is published as Functions/index.md without requiring module authors to change their existing documentation workflow.

---

Technical details

• Added authored root index fixtures to tests/srcTestRepo and tests/srcWithManifestTestRepo.
• Extended Workflow-Test-Default.yml and Workflow-Test-WithManifest.yml to run for fixture changes and verify the generated root index content.
• Reused the existing Build-PSModuleDocumentation.ps1 move logic; no generator change was required.
• Implementation plan progress: completed the first slice for fully authored root indexes. Placeholder-driven generated submodule tables remain follow-up work.

Changed surface	Standards checked	Framework docs checked	Result
tests/** (PowerShell fixtures)	Test fixture conventions	Process-PSModule test workflow	Aligned
.github/workflows/** (GitHub Actions)	Workflow conventions	Process-PSModule documentation pipeline	Aligned

• Issue convergence sweep: reviewed Generate a Functions landing page that indexes all commands grouped by section #379; this PR delivers the authored-root-index slice only, while placeholder and generated-table behavior remains open.

Relevant issues (or links)

• Generate a Functions landing page that indexes all commands grouped by section #379

[github-actions]

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
MARKDOWN	Fail ❌
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Pass ✅
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

Super-linter detected linting errors

For more information, see the GitHub Actions workflow run

Powered by Super-linter

MARKDOWN

/github/workspace/tests/srcWithManifestTestRepo/src/functions/public/index.md:6 error MD025/single-title/single-h1 Multiple top-level headings in the same document [Context: "Functions"]