Fix various missing comment based help and parameter help test.

Author: homotechsual

HaloAPI.build.ps1

@@ -52,6 +52,7 @@ if ($UpdateHelp) {
         Exclude = $ExcludeFiles
         Sidebar = 'commandlets'
         # MetaDescription = 'Generated cmdlet help for the %1 commandlet.'
+        NoPlaceHolderExamples = $true
         GroupByVerb = $true
         UseDescriptionFromHelp = $true
     }

Public/Get/Get-HaloAssetType.ps1

@@ -55,6 +55,7 @@ function Get-HaloAssetType {
         # Include the last action in the result.
         [Parameter( ParameterSetName = 'Single' )]
         [Switch]$IncludeDiagramDetails,
+        # Show all assets, including those that have been deleted.
         [Parameter( ParameterSetName = 'Multi')]
         [Switch]$ShowAll
     )

Public/Get/Get-HaloOutcome.ps1

@@ -1,26 +1,42 @@
-# Get-HaloOutcome.ps1
+#Requires -Version 7
 function Get-HaloOutcome {
+    <#
+        .SYNOPSIS
+            Gets outcomes from the Halo API.
+        .DESCRIPTION
+            Retrieves outcomes from the Halo API - supports a variety of filtering parameters.
+        .OUTPUTS
+            A powershell object containing the response.
+    #>
     [CmdletBinding( DefaultParameterSetName = 'Multi' )]
     [OutputType([Object])]
     [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSReviewUnusedParameter', '', Justification = 'Uses dynamic parameter parsing.')]
     Param(
+        # The id of the outcome to retrieve.
         [Parameter( ParameterSetName = 'Single', Mandatory = $True )]
-        [int64]$OutcomeID,
+        [int64]$OutcomeId,
+        # The number of results to return.
         [Parameter( ParameterSetName = 'Multi' )]
         [int64]$Count,
+        # Enable pagination.
         [Parameter( ParameterSetName = 'Multi' )]
         [Alias('pageinate')]
         [switch]$Paginate,
+        # The number of results per page.
         [Parameter( ParameterSetName = 'Multi' )]
         [Alias('page_size')]
         [int32]$PageSize,
+        # The page number to return.
         [Parameter( ParameterSetName = 'Multi' )]
         [Alias('page_no')]
         [int32]$PageNo,
+        # The field to order results by.
         [Parameter( ParameterSetName = 'Multi' )]
         [string]$Order,
+        # Order results in descending order (respects the field choice in '-Order')
         [Parameter( ParameterSetName = 'Multi' )]
         [switch]$OrderDesc,
+        # Include details in the response.
         [Parameter( ParameterSetName = 'Single' )]
         [switch]$IncludeDetails
     )

Public/Get/Get-HaloTicketRules.ps1

@@ -16,13 +16,15 @@ function Get-HaloTicketRules {
         [Parameter( ParameterSetName = 'Single', Mandatory = $True )]
         [int64]$RuleID,
         [Parameter( ParameterSetName = 'Single' )]
+        # Include details in the response.
         [switch]$IncludeDetails,
+        # Include criteria info in the response.
         [Parameter( ParameterSetName = 'Single' )]
         [switch]$IncludeCriteriaInfo,
-        # Include Workflow Step Rules
+        # Exclude Workflow Step Rules
         [Parameter( ParameterSetName = 'Multi')]
         [switch]$ExcludeWorkflow,
-        # ShowAll
+        # Show all rules, including those that have been deleted.
         [Parameter( ParameterSetName = 'Multi' )]
         [switch]$ShowAll
     )

Public/New/New-HaloOutcome.ps1

@@ -1,8 +1,17 @@
-# New-HaloOutcome.ps1
+#Requires -Version 7
 Function New-HaloOutcome {
+    <#
+        .SYNOPSIS
+            Creates one or more outcomes via the Halo API.
+        .DESCRIPTION
+            Function to send a outcome creation request to the Halo API
+        .OUTPUTS
+            Outputs an object containing the response from the web request.
+    #>
     [CmdletBinding( SupportsShouldProcess = $True )]
     [OutputType([Object[]])]
     Param (
+        # Object or array of objects containing properties and values used to create one or more new outcomes.
         [Parameter( Mandatory = $True )]
         [Object[]]$Outcome
     )