Create XML-based help (#14334)

* Create XML-based help

* remove xml

Author: dingmeng-xue

.azure-pipelines/sign-tool-predictor.yml

@@ -41,7 +41,7 @@ steps:
   inputs:
     command: custom
     custom: msbuild
-    arguments: 'tools\Az.Tools.Predictor\build.proj /target:"Clean;Build" /p:Configuration=Release'
+    arguments: 'tools\Az.Tools.Predictor\build.proj /target:"Clean;Build;GenerateHelp" /p:Configuration=Release'
 
 - task: UseDotNet@2
   displayName: 'Install DotNet 2.1 Runtime for Signing'

tools/Az.Tools.Predictor/GenerateHelp.ps1

@@ -0,0 +1,14 @@
+#Requires -Modules platyPS
+[CmdletBinding()]
+Param(
+    [Parameter()]
+    [string]$ArtifactFolder,
+    [Parameter()]
+    [string]$ModuleName
+)
+
+$ModuleFolder = Join-Path -Path $ArtifactFolder -ChildPath $ModuleName
+$TempDocFolder = Join-Path -Path $ArtifactFolder -ChildPath $ModuleName'.Doc'
+Import-Module $ModuleFolder
+New-MarkdownHelp -Module $ModuleName -OutputFolder $TempDocFolder
+New-ExternalHelp –Path $TempDocFolder -OutputPath $ModuleFolder

tools/Az.Tools.Predictor/build.proj

@@ -3,6 +3,9 @@
   xmlns="http://schemas.microsoft.com/developer/msbuild/2003" Target="Build">
 
   <Import Project="$(MSBuildThisFileDirectory)..\..\Repo.props" />
+  <PropertyGroup>
+    <PowerShellCoreCommandPrefix>pwsh -NonInteractive -NoLogo -NoProfile -Command</PowerShellCoreCommandPrefix>
+  </PropertyGroup>
 
   <PropertyGroup>
     <Configuration Condition="'$(Configuration)' != 'Release'">Debug</Configuration>
@@ -31,6 +34,10 @@
     <Exec Command="dotnet $(BuildAction) $(ModuleSolutionFile) -c $(Configuration)" />
   </Target>
 
+  <Target Name="GenerateHelp">
+    <Exec Command="$(PowerShellCoreCommandPrefix) &quot;.\GenerateHelp -ArtifactFolder $(ArtifactFolder) -ModuleName $(ModuleName)" />
+  </Target>
+
   <Target Name="Test" DependsOnTargets="Build">
     <Message Importance="high" Text="Running check in tests..." />
     <MakeDir Directories="$(TestOutputDirectory)" ContinueOnError="false" />