From 7d398f6cde87cc736bd3549d88f5951dd6368dc4 Mon Sep 17 00:00:00 2001
From: dingmeng-xue <dixue@microsoft.com>
Date: Wed, 24 Feb 2021 23:47:41 +0800
Subject: [PATCH 1/2] Create XML-based help

---
 .azure-pipelines/sign-tool-predictor.yml  |  3 ++-
 tools/Az.Tools.Predictor/GenerateHelp.ps1 | 14 ++++++++++++++
 tools/Az.Tools.Predictor/build.proj       |  7 +++++++
 3 files changed, 23 insertions(+), 1 deletion(-)
 create mode 100644 tools/Az.Tools.Predictor/GenerateHelp.ps1

diff --git a/.azure-pipelines/sign-tool-predictor.yml b/.azure-pipelines/sign-tool-predictor.yml
index 504890496afa..6875d44b3e62 100644
--- a/.azure-pipelines/sign-tool-predictor.yml
+++ b/.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'
@@ -59,6 +59,7 @@ steps:
      Tools/**/*.psd1
      Tools/**/*.psm1
      Tools/**/*.ps1xml
+     Tools/**/*.xml
     UseMinimatch: true
     signConfigType: inlineSignParams
     inlineOperation: |
diff --git a/tools/Az.Tools.Predictor/GenerateHelp.ps1 b/tools/Az.Tools.Predictor/GenerateHelp.ps1
new file mode 100644
index 000000000000..5cc67611792c
--- /dev/null
+++ b/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
\ No newline at end of file
diff --git a/tools/Az.Tools.Predictor/build.proj b/tools/Az.Tools.Predictor/build.proj
index 190970032a41..33f16e8f62d2 100644
--- a/tools/Az.Tools.Predictor/build.proj
+++ b/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" />

From 3850e41b339d5414dba90958bd601259543ebc38 Mon Sep 17 00:00:00 2001
From: dingmeng-xue <dixue@microsoft.com>
Date: Thu, 25 Feb 2021 00:03:18 +0800
Subject: [PATCH 2/2] remove xml

---
 .azure-pipelines/sign-tool-predictor.yml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.azure-pipelines/sign-tool-predictor.yml b/.azure-pipelines/sign-tool-predictor.yml
index 6875d44b3e62..e980c5b8f550 100644
--- a/.azure-pipelines/sign-tool-predictor.yml
+++ b/.azure-pipelines/sign-tool-predictor.yml
@@ -59,7 +59,6 @@ steps:
      Tools/**/*.psd1
      Tools/**/*.psm1
      Tools/**/*.ps1xml
-     Tools/**/*.xml
     UseMinimatch: true
     signConfigType: inlineSignParams
     inlineOperation: |