⚙️ [Maintenance]: Showcase both docs section landing-page conventions (index.md + folder-named) (#27)
Two example command groups demonstrate both supported ways to give a command group its documentation section landing page. IndexSection provides its landing page as index.md; NamedSection provides its landing page as a file named after the folder (NamedSection.md). Document-PSModule renders either overview page as the group's section landing page, so each group appears at Functions/<Group>/ in the navigation of the published GitHub Pages site.
- Demonstrates PSModule/Process-PSModule#372 (group overview pages become section landing pages)
- Adopts PSModule/Process-PSModule#377 (caller-provided TestData reaches module tests in consumer repositories)
New: Two command groups showcasing both landing-page conventions
IndexSection/— landing page fromindex.md, withGet-IndexSectionTest.NamedSection/— landing page from the folder-namedNamedSection.md, withGet-NamedSectionTest.
Each renders as its group's section landing page (Functions/IndexSection/ and Functions/NamedSection/) in the docs navigation.
Technical Details
- Adds
src/functions/public/IndexSection/{index.md, Get-IndexSectionTest.ps1}andsrc/functions/public/NamedSection/{NamedSection.md, Get-NamedSectionTest.ps1}; both functions mirror the existing*-PSModuleTestshape and returnHello, <Name>!. - Adds
Itblocks forGet-IndexSectionTestandGet-NamedSectionTestintests/PSModuleTest.Tests.ps1. - Generated docs place each group overview at
<Group>/index.md; the rendered site exposesFunctions/IndexSection/index.htmlandFunctions/NamedSection/index.html. - Bumps the Process-PSModule pin (
v6.1.1→v6.1.2) to adopt the fix that exposes caller-providedTestDatato the module test jobs, keeping the module test matrix green.