feat: Alias and Breakingchange through PSA

.azure-pipelines/vscode-extension.yml

@@ -18,8 +18,7 @@ steps:
 - script: |
     pushd vscode-extension
     npm install
-    npm run lint
-    npm run compile
+    npm run lint && npm run compile
     if [ $? -ne 0 ]; then
         exit 1
     fi

docs/how-to-generate-az-module-alias-spec-and-breaking-change-spec.md

@@ -0,0 +1,90 @@
+# How to generate Az Module alias spec and breaking change spec
+
+The alias specifications and breaking change specifications are separately stored in `vscode-extension/PSA_Custom_Rules/Alias/AliasSpec.json` and `vscode-extension/PSA_Custom_Rules/BreakingChange/BreakingchangeSpec.json`
+
+## Generation Instruction
+
+1. Install all az.* modules by `Install-Module azpreview`
+
+2. Import all az.* modules
+   ```powershell
+   $az_modules = gmo az.* -ListAvailable
+   for ([int]$i = 0; $i -lt $az_modules.Count; $i++){
+        import-module $az_modules[$i].name
+    }
+   ```
+
+3. Get the Az Modules alias information and save into `vscode-extension/PSA_Custom_Rules/Alias/AliasSpec.json`
+   ```powershell
+   cd vscode-extension/PSA_Custom_Rules/Alias
+   ./geneAlias.ps1
+   ```
+
+3. Get the Az Modules breaking change information and save into `vscode-extension/PSA_Custom_Rules/BreakingChange/BreakingchangeSpec.json`
+   ```powershell
+   cd vscode-extension/PSA_Custom_Rules/BreakingChange
+   ./geneBreakingChange.ps1
+   ```
+
+## Specification Instruction
+
+1. Alias Spec
+   ```json
+   {
+        "cmdlet":    //The alias of cmdlets
+       {
+           "{Alias Cmdlet Name}": "{Formal Name of the Cmdlet}",
+           ...
+       },
+       "para_cmdlet":   //The alias of cmdlets' parameters 
+       {
+           "{Name of Cmdlet}":
+           {
+               "{Alias Parameter Name}": "{Formal Name of the Parameter}",
+               ...
+           },
+           ...
+       }
+   }
+   ```
+
+2. Breaking Change Spec
+   ```json
+   {
+        "cmdlet":    //The breaking changes of cmdlets
+        [
+            {
+                "Name": "{The name of the cmdlet}",
+                "TypeBreakingChange": "The type of breaking change attribution"
+            },
+            ...
+        ]
+
+       "para_cmdlet":   //The breaking changes of cmdlets' parameters 
+       [
+           {
+               "Name": "{The name of the parameter}",
+                "TypeBreakingChange": "The type of breaking change attribution",
+                "CmdletName": "{The name of the cmdlet which the parameter belongs to}"
+           },
+           ...
+       ]
+       "func":    //The breaking changes of functions
+       [
+           {
+                "Name": "{The name of the function}",
+                "TypeBreakingChange": "The type of breaking change attribution"
+           },
+           ...
+       ]
+       "para_func":   //The breaking changes of functions' parameters
+       [
+           {
+                "Name": "{The name of the parameter}",
+                "TypeBreakingChange": "The type of breaking change attribution",
+                "FuncName": "{The name of the function which the parameter belongs to}"
+           },
+           ...
+       ] 
+   }
+   ```

vscode-extension/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Azure PowerShell Extension Release History
 
+## 0.3.0
+Add new features:
+- Detect alias cmdlets or parameters, then you can quick-fix it to formal name
+- Detect upcoming breaking change cmdlets or paramters and give some message about the change
+
 ## 0.2.0
 
 Code refactoring and user experience optimization: