🩹 [Patch]: Add example of nested docs (#12)

## Description

This pull request introduces several updates to the PSModule functions,
including module dependency updates, file restructuring, and new
documentation. It also adds a custom argument completer for the
`New-PSModuleTest` command. The most important changes are summarized
below:

### Module dependency updates and file restructuring

* Updated module dependencies in `Get-PSModuleTest.ps1` and
`New-PSModuleTest.ps1` to require newer versions of `PSSemVer`, and
added dependencies on `DynamicParams` and `Store`. Both files were also
moved into the `PSModule` subfolder and renamed accordingly.
[[1]](diffhunk://#diff-fba04a7dcc2a3fdf6ced8c431c15ae38c72351bd21fec3705f09d1fbb19343b0R2-R4)
[[2]](diffhunk://#diff-67673b63bb813016a3286857ec190afb041ce4352b18c7ba8571de3d6213e771L1-R1)
* Updated `.github/PSModule.yml` to configure the linter environment
variable `VALIDATE_BIOME_FORMAT` to `false`.

### New features

* Added a custom argument completer in `completers.ps1` for the
`New-PSModuleTest` command's `Name` parameter, providing suggestions
such as 'Alice', 'Bob', and 'Charlie'.

### Documentation

* Added a new markdown documentation file `PSModule.md` in the
`PSModule` folder.
* Added a new markdown documentation file `SomethingElse.md` in the
`SomethingElse` folder.

Author: MariusStorhaug

.github/PSModule.yml

@@ -20,6 +20,7 @@ Test:
 # Build:
 #   Docs:
 #     Skip: true
+
 Linter:
   env:
     VALIDATE_BIOME_FORMAT: false

src/functions/public/Get-PSModuleTest.ps1 …ons/public/PSModule/Get-PSModuleTest.ps1src/functions/public/Get-PSModuleTest.ps1 renamed to src/functions/public/PSModule/Get-PSModuleTest.ps1 src/functions/public/Get-PSModuleTest.ps1 renamed to src/functions/public/PSModule/Get-PSModuleTest.ps1

@@ -1,4 +1,7 @@
 #Requires -Modules Utilities
+#Requires -Modules @{ ModuleName = 'PSSemVer'; RequiredVersion = '1.1.4' }
+#Requires -Modules @{ ModuleName = 'DynamicParams'; ModuleVersion = '1.1.8' }
+#Requires -Modules @{ ModuleName = 'Store'; ModuleVersion = '0.3.1' }
 
 function Get-PSModuleTest {
     <#

src/functions/public/New-PSModuleTest.ps1 …ons/public/PSModule/New-PSModuleTest.ps1src/functions/public/New-PSModuleTest.ps1 renamed to src/functions/public/PSModule/New-PSModuleTest.ps1 src/functions/public/New-PSModuleTest.ps1 renamed to src/functions/public/PSModule/New-PSModuleTest.ps1

@@ -1,4 +1,4 @@
-#Requires -Modules @{ModuleName='PSSemVer'; ModuleVersion='1.0'}
+#Requires -Modules @{ModuleName='PSSemVer'; ModuleVersion='1.1.4'}
 
 function New-PSModuleTest {
     <#

src/functions/public/PSModule/PSModule.md

@@ -0,0 +1 @@
+# This is PSModule

src/functions/public/Set-PSModuleTest.ps1 …ublic/SomethingElse/Set-PSModuleTest.ps1src/functions/public/Set-PSModuleTest.ps1 renamed to src/functions/public/SomethingElse/Set-PSModuleTest.ps1 src/functions/public/Set-PSModuleTest.ps1 renamed to src/functions/public/SomethingElse/Set-PSModuleTest.ps1

@@ -0,0 +1 @@
+# This is SomethingElse

src/functions/public/SomethingElse/SomethingElse.md

@@ -0,0 +1,8 @@
+Register-ArgumentCompleter -CommandName New-PSModuleTest -ParameterName Name -ScriptBlock {
+    param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters)
+    $null = $commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters
+
+    'Alice', 'Bob', 'Charlie' | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
+        [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
+    }
+}