Document action scripts per MSX standard

Add comment-based help blocks and inline parameter documentation to new action PowerShell entry scripts to align with MSXOrg/docs script standards.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Author: MariusStorhaug

.github/actions/Build-ZensicalSite/src/main.ps1

@@ -1,7 +1,25 @@
 #Requires -Version 7.0
 
+<#
+    .SYNOPSIS
+    Builds the Zensical site and normalizes output to the expected _site path.
+
+    .DESCRIPTION
+    Runs zensical build from outputs/site and moves the generated _site directory
+    to <WorkingDirectory>/_site for downstream workflow steps.
+
+    .EXAMPLE
+    ./main.ps1 -WorkingDirectory '.'
+
+    .INPUTS
+    None.
+
+    .OUTPUTS
+    None.
+#>
 [CmdletBinding()]
 param(
+    # Build working directory containing outputs/site and destination _site.
     [Parameter(Mandatory)]
     [string]$WorkingDirectory
 )

.github/actions/Inject-SiteScripts/src/main.ps1

@@ -1,10 +1,29 @@
 #Requires -Version 7.0
 
+<#
+    .SYNOPSIS
+    Injects shared JavaScript snippets into generated site HTML files.
+
+    .DESCRIPTION
+    Reads scripts from .github/scripts/site-injectors in the checked out workflow
+    repository and injects each script into every HTML file under SitePath, once per file.
+
+    .EXAMPLE
+    ./main.ps1 -SitePath './_site' -WorkflowPath '_wf'
+
+    .INPUTS
+    None.
+
+    .OUTPUTS
+    None.
+#>
 [CmdletBinding()]
 param(
+    # Path to generated site output directory containing HTML files.
     [Parameter(Mandatory)]
     [string]$SitePath,
 
+    # Relative path to the checked out workflow repository root.
     [Parameter(Mandatory)]
     [string]$WorkflowPath
 )

.github/actions/Install-Zensical/src/main.ps1

@@ -1,5 +1,21 @@
 #Requires -Version 7.0
 
+<#
+    .SYNOPSIS
+    Installs the Zensical CLI used by site build workflows.
+
+    .DESCRIPTION
+    Installs the zensical Python package in the current runner environment.
+
+    .EXAMPLE
+    ./main.ps1
+
+    .INPUTS
+    None.
+
+    .OUTPUTS
+    None.
+#>
 [CmdletBinding()]
 param()
 

.github/actions/Structure-Site/src/main.ps1

@@ -1,10 +1,29 @@
 #Requires -Version 7.0
 
+<#
+    .SYNOPSIS
+    Structures generated documentation content and writes a resolved site config.
+
+    .DESCRIPTION
+    Copies generated docs, README, and assets into outputs/site and resolves zensical.toml
+    placeholders and site_dir for build execution.
+
+    .EXAMPLE
+    ./main.ps1 -WorkingDirectory '.' -Name 'MyModule'
+
+    .INPUTS
+    None.
+
+    .OUTPUTS
+    None.
+#>
 [CmdletBinding()]
 param(
+    # Build working directory where src/, README.md, and outputs/ exist.
     [Parameter(Mandatory)]
     [string]$WorkingDirectory,
 
+    # Optional module name override used for placeholder replacement.
     [Parameter()]
     [string]$Name
 )