Add script and module to generate help, add exceptions file, and add script to build.proj

Author: cormacpayne

build.proj

@@ -182,14 +182,16 @@
       Targets="Build"
       Properties="Configuration=$(Configuration);Platform=Any CPU"
       BuildInParallel="$(BuildInParallel)"
-      ContinueOnError="false" />
+      ContinueOnError="false" />   	
 
     <CallTarget Targets="BuildSetupTest"/>
 	<CallTarget Targets="CodeSignBinaries" Condition=" '$(CodeSign)' == 'true' " />	
 	<CallTarget Targets="BuildSetup"/>
 	<CallTarget Targets="CodeSignInstaller"
                 Condition=" '$(CodeSign)' == 'true' and '$(Scope)' == 'all'" />
-	
+	<Exec Command="$(PowerShellCommand) -NonInteractive -NoLogo -NoProfile -Command &quot;. $(LibraryToolsFolder)\GenerateHelp.ps1 -ValidateMarkdownHelp &quot;"/>
+	<Exec Command="$(PowerShellCommand) -NonInteractive -NoLogo -NoProfile -Command &quot;. $(LibraryToolsFolder)\GenerateHelp.ps1 -GenerateMarkdownHelp &quot;"
+				Condition=" '$(CodeSign)' == 'true' " />
 	<Message Importance="high" Text="Running Static Analyser" />
     <CallTarget targets="DependencyAnalysis" />
   </Target>

tools/GenerateHelp.ps1

@@ -0,0 +1,36 @@
+#Requires -Modules platyPS
+
+[CmdletBinding()]
+Param(
+    [Parameter()]
+    [Switch]$ValidateMarkdownHelp,
+
+    [Parameter()]
+    [Switch]$GenerateMamlHelp
+)
+
+Import-Module "$PSScriptRoot\HelpGeneration\HelpGeneration.psm1"
+
+$HelpFolders = Get-ChildItem "help" -Recurse -Directory | where { $_.FullName -like "*Debug*" }
+
+# ---------------------------------------------------------------------------------------------
+
+if ($ValidateMarkdownHelp)
+{
+    New-Item -Path "$PSScriptRoot\HelpGeneration\Exceptions" -Name NewValidateHelpExceptions.csv -ItemType File -Force | Out-Null
+
+    Add-Content "$PSscriptRoot\HelpGeneration\Exceptions\NewValidateHelpExceptions.csv" "Module,Target,Description"
+
+    $HelpFolders | foreach { Validate-MarkdownHelp $_ }
+
+    $Exceptions = Import-Csv "$PSScriptRoot\HelpGeneration\Exceptions\NewValidateHelpExceptions.csv"
+
+    $Exceptions | ft
+
+    Remove-Item -Path "$PSScriptRoot\HelpGeneration\Exceptions\NewValidateHelpExceptions.csv" -Force
+}
+
+if ($GenerateMamlHelp)
+{
+    $HelpFolders | foreach { Generate-MamlHelp $_ }
+}