⚙️ [Maintenance]: Showcase docs section landing-page conventions on Process-PSModule v6.1.2

.github/workflows/Process-PSModule.yml

@@ -27,7 +27,7 @@ permissions:
 
 jobs:
   Process-PSModule:
-    uses: PSModule/Process-PSModule/.github/workflows/workflow.yml@ea19a3eb1293246d1b00e4faae1544442c3be0ec # v6.1.1
+    uses: PSModule/Process-PSModule/.github/workflows/workflow.yml@d4020f3c9c3621cebae5d8bf4ffaf10f55c1784a # v6.1.2
     secrets:
       APIKEY: ${{ secrets.APIKEY }}
       # Showcase: send data down to the module tests (see tests/Environment.Tests.ps1).

src/functions/public/IndexSection/Get-IndexSectionTest.ps1

@@ -0,0 +1,21 @@
+function Get-IndexSectionTest {
+    <#
+        .SYNOPSIS
+        Performs tests on a module.
+
+        .DESCRIPTION
+        Performs tests on a module.
+
+        .EXAMPLE
+        Get-IndexSectionTest -Name 'World'
+
+        "Hello, World!"
+    #>
+    [CmdletBinding()]
+    param (
+        # Name of the person to greet.
+        [Parameter(Mandatory)]
+        [string] $Name
+    )
+    Write-Output "Hello, $Name!"
+}

src/functions/public/IndexSection/index.md

@@ -0,0 +1,5 @@
+# Index Section
+
+This section's landing page is provided by an `index.md` file.
+
+When Process-PSModule builds the documentation site, this page becomes the landing page for the **Index Section** group in the navigation on GitHub Pages.

src/functions/public/NamedSection/Get-NamedSectionTest.ps1

@@ -0,0 +1,21 @@
+function Get-NamedSectionTest {
+    <#
+        .SYNOPSIS
+        Performs tests on a module.
+
+        .DESCRIPTION
+        Performs tests on a module.
+
+        .EXAMPLE
+        Get-NamedSectionTest -Name 'World'
+
+        "Hello, World!"
+    #>
+    [CmdletBinding()]
+    param (
+        # Name of the person to greet.
+        [Parameter(Mandatory)]
+        [string] $Name
+    )
+    Write-Output "Hello, $Name!"
+}

src/functions/public/NamedSection/NamedSection.md

@@ -0,0 +1,5 @@
+# Named Section
+
+This section's landing page is provided by a file named after its folder (`NamedSection.md`).
+
+When Process-PSModule builds the documentation site, this page becomes the landing page for the **Named Section** group in the navigation on GitHub Pages.

tests/PSModuleTest.Tests.ps1

@@ -22,4 +22,10 @@ Describe 'Module' {
     It 'Function: Test-PSModuleTest' {
         Test-PSModuleTest -Name 'World' | Should -Be 'Hello, World!'
     }
+    It 'Function: Get-IndexSectionTest' {
+        Get-IndexSectionTest -Name 'World' | Should -Be 'Hello, World!'
+    }
+    It 'Function: Get-NamedSectionTest' {
+        Get-NamedSectionTest -Name 'World' | Should -Be 'Hello, World!'
+    }
 }