Add syntax changelog when release (#23745)

* Update code-oob.yml for Azure Pipelines

* delete versioninfo in root folder

* delete versioninfo in root folder

* add syntax changelog

* fix changelog

Author: Nickcandy

tools/RunVersionController.ps1

@@ -164,10 +164,10 @@ function Update-ChangeLog
         [Parameter(Mandatory = $true)]
         [string[]]$Content,
         [Parameter(Mandatory = $true)]
-        [string]$RootPath
+        [string]$FilePath
     )
 
-    $ChangeLogFile = Get-Item -Path "$RootPath\ChangeLog.md"
+    $ChangeLogFile = Get-Item -Path $FilePath
     $ChangeLogContent = Get-Content -Path $ChangeLogFile.FullName
     ($Content + $ChangeLogContent) | Set-Content -Path $ChangeLogFile.FullName -Encoding UTF8
 }
@@ -295,7 +295,7 @@ function Bump-AzVersion
     }
 
     Update-ModuleManifest -Path "$PSScriptRoot\Az\Az.psd1" -ModuleVersion $newVersion -ReleaseNotes $releaseNotes
-    Update-ChangeLog -Content $changeLog -RootPath $rootPath
+    Update-ChangeLog -Content $changeLog -FilePath "$rootPath\ChangeLog.md"
 
     New-CommandMappingFile
 
@@ -392,8 +392,26 @@ function Update-AzPreviewChangelog
         $changeLog += "#### $updatedModule $($moduleMetadata.ModuleVersion)"
         $changeLog += $moduleReleaseNotes + "`n"
     }
-    Update-ChangeLog -Content $changeLog -RootPath $rootPath/tools/AzPreview
+    Update-ChangeLog -Content $changeLog -FilePath "$rootPath/tools/AzPreview/ChangeLog.md"
+}
 
+function Update-AzSyntaxChangelog
+{
+    Write-Host "starting revise SyntaxChangelog"
+    $rootPath = "$PSScriptRoot\.."
+    $NewVersion = (Import-PowerShellDataFile "$PSScriptRoot\Az\Az.psd1").ModuleVersion
+    Update-ChangeLog -Content "## $NewVersion - $Release" -FilePath "$rootPath\documentation\SyntaxChangelog.md"
+    $changeLog = Get-Content "$rootPath\documentation\SyntaxChangelog.md" -Raw
+    $regex = '####\s+(Az\.\w+)\s+(?![\d\.])'
+    $matches = Select-String -Pattern $regex -InputObject $changelog -AllMatches
+    foreach ($match in $matches.Matches) {
+        $moduleName = $match.Groups[1].Value
+        $moduleMetadata = Get-ModuleMetadata -Module $moduleName -RootPath $rootPath
+        $newVersion = $moduleMetadata.ModuleVersion
+        $replacement = "#### $moduleName $newVersion `r`n"
+        $changelog = $changelog -replace [regex]::Escape($match.Value), $replacement
+    }
+    Set-Content -Path "$rootPath\documentation\SyntaxChangelog.md" -Value $changelog
 }
 
 function New-CommandMappingFile
@@ -502,6 +520,7 @@ switch ($PSCmdlet.ParameterSetName)
         # Refresh AzPreview.psd1
         Update-AzPreview
         Update-AzPreviewChangelog
+        Update-AzSyntaxChangelog
         # We need to generate the upcoming-breaking-changes.md after the process of bump version in minor release
         if ([PSVersion]::MINOR -Eq $versionBump)
         {

tools/VersionController/Models/CmdletDiffInfomation.cs

@@ -0,0 +1,39 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace VersionController.Netcore.Models
+{
+    public enum ChangeType
+    {
+        CmdletAdd,
+        CmdletRemove,
+        CmdletSupportsShouldProcessChange,
+        CmdletSupportsPagingChange,
+        AliasAdd,
+        AliasRemove,
+        ParameterAdd,
+        ParameterRemove,
+        ParameterAliasAdd,
+        ParameterAliasRemove,
+        ParameterTypeChange,
+        ParameterAttributeChange,
+        ParameterSetAdd,
+        ParameterSetRemove,
+        ParameterSetAttributePropertyChange,
+        OutputTypeChange
+    }
+    public class CmdletDiffInformation
+    {
+        public string ModuleName { get; set; }
+        public string CmdletName { get; set; }
+        public ChangeType Type { get; set; }
+        public string ParameterSetName { get; set; }
+        public string ParameterName { get; set; }
+        public List<string> Before { get; set; }
+        public List<string> After { get; set; }
+        public string PropertyName { get; set; }
+    }
+}