Showcase both docs section landing-page conventions (index.md + folder-named)

Add two example command groups exercising both overview-page conventions: IndexSection uses index.md as its section landing page, NamedSection uses a folder-named NamedSection.md. Adds Get-IndexSectionTest and Get-NamedSectionTest plus their Pester tests. Template already runs Process-PSModule v6.1.1 (#26).

Author: MariusStorhaug

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!'
+    }
 }