🪲 [Fix]: Fix linter settings and docs (#13)

This pull request introduces minor configuration and documentation
updates to improve code linting controls and script clarity. The changes
focus on adjusting linter settings, updating markdown lint rules, and
enhancing script documentation.

Linter configuration updates:

*
[`.github/PSModule.yml`](diffhunk://#diff-928165ed381f1982eb8f9746a59a2829db4abc8a28eddb8c109e12bb033ff96aR22-R31):
Added a `Linter` section to explicitly disable several validation checks
(such as Biome, JSCPD, various Prettier checks, and GitHub Actions
Zizmor) by setting their environment variables to `false`.

Markdown linting rule adjustments:

*
[`.github/linters/.markdown-lint.yml`](diffhunk://#diff-2fd3619d2b7372123257bc21645edb90c24293e66babbc6053033a89e21bab34R16-R18):
Disabled the `MD024` rule (no duplicate headings) to allow repeated
headings like INPUTS and OUTPUTS, and made a minor punctuation
formatting change for the `MD026` rule.

Documentation improvement:

*
[`src/functions/public/Test-PSModuleTemplate.ps1`](diffhunk://#diff-5900b9f47599d281b3ed9668242d5b52d0767a84e7a988ba48fdd77faa027007R6-R8):
Added a `.DESCRIPTION` section to the comment-based help, clarifying the
purpose of the function.

Author: MariusStorhaug

.github/PSModule.yml

@@ -19,3 +19,13 @@ Test:
 # Build:
 #   Docs:
 #     Skip: true
+
+Linter:
+  env:
+    VALIDATE_BIOME_FORMAT: false
+    VALIDATE_BIOME_LINT: false
+    VALIDATE_GITHUB_ACTIONS_ZIZMOR: false
+    VALIDATE_JSCPD: false
+    VALIDATE_JSON_PRETTIER: false
+    VALIDATE_MARKDOWN_PRETTIER: false
+    VALIDATE_YAML_PRETTIER: false

.github/linters/.markdown-lint.yml

@@ -8,18 +8,19 @@
 ###############
 # Rules by id #
 ###############
-MD004: false                  # Unordered list style
+MD004: false # Unordered list style
 MD007:
-  indent: 2                   # Unordered list indentation
+  indent: 2 # Unordered list indentation
 MD013:
-  line_length: 808            # Line length
+  line_length: 808 # Line length
+MD024: false # no-duplicate-heading, INPUTS and OUTPUTS _can_ be the same item
 MD026:
-  punctuation: ".,;:!。，；:"  # List of not allowed
-MD029: false                  # Ordered list item prefix
-MD033: false                  # Allow inline HTML
-MD036: false                  # Emphasis used instead of a heading
+  punctuation: '.,;:!。，；:' # List of not allowed
+MD029: false # Ordered list item prefix
+MD033: false # Allow inline HTML
+MD036: false # Emphasis used instead of a heading
 
 #################
 # Rules by tags #
 #################
-blank_lines: false  # Error on blank lines
+blank_lines: false # Error on blank lines

src/functions/public/Test-PSModuleTemplate.ps1

@@ -3,6 +3,9 @@
         .SYNOPSIS
         Performs tests on a module.
 
+        .DESCRIPTION
+        Performs tests on a module.
+
         .EXAMPLE
         Test-PSModuleTemplate -Name 'World'