Updates Compute.Json to improve Documentation around PerformMaintenan…

specification/compute/resource-manager/Microsoft.Compute/stable/2019-07-01/compute.json

@@ -2597,7 +2597,7 @@
           "VirtualMachines"
         ],
         "operationId": "VirtualMachines_ConvertToManagedDisks",
-        "description": "Converts virtual machine disks from blob-based to managed disks. Virtual machine must be stop-deallocated before invoking this operation.",
+        "description": "Converts virtual machine disks from blob-based to managed disks. Virtual machine must be stop-deallocated before invoking this operation. <br>For Windows, please refer to [Convert a virtual machine from unmanaged disks to managed disks.](https://docs.microsoft.com/en-us/azure/virtual-machines/windows/convert-unmanaged-to-managed-disks).<br>For Linux, please refer to [Convert a virtual machine from unmanaged disks to managed disks.](https://docs.microsoft.com/en-us/azure/virtual-machines/linux/convert-unmanaged-to-managed-disks).",
         "parameters": [
           {
             "name": "resourceGroupName",
@@ -2628,6 +2628,11 @@
             "description": "Accepted"
           }
         },
+        "x-ms-examples": {
+          "Generalize a Virtual Machine.": {
+            "$ref": "./examples/ConvertToManagedDisks.json"
+          }
+        },
         "x-ms-long-running-operation": true
       }
     },
@@ -3108,7 +3113,7 @@
           "VirtualMachines"
         ],
         "operationId": "VirtualMachines_PerformMaintenance",
-        "description": "The operation to perform maintenance on a virtual machine.",
+        "description": "Shuts down the virtual machine, moves it to an already updated node, and powers it back on during the self-service phase of planned maintenance.",
         "parameters": [
           {
             "name": "resourceGroupName",
@@ -5552,7 +5557,7 @@
           "VirtualMachineScaleSetVMs"
         ],
         "operationId": "VirtualMachineScaleSetVMs_PerformMaintenance",
-        "description": "Performs maintenance on a virtual machine in a VM scale set.",
+        "description": "Shuts down the virtual machine in a VMScaleSet, moves it to an already updated node, and powers it back on during the self-service phase of planned maintenance.",
         "parameters": [
           {
             "name": "resourceGroupName",

specification/compute/resource-manager/Microsoft.Compute/stable/2019-07-01/examples/ConvertToManagedDisks.json

@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2019-07-01",
+    "vmName": "myVMName"
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}

specification/compute/resource-manager/Microsoft.Compute/stable/2019-12-01/compute.json

@@ -2894,7 +2894,7 @@
           "VirtualMachines"
         ],
         "operationId": "VirtualMachines_ConvertToManagedDisks",
-        "description": "Converts virtual machine disks from blob-based to managed disks. Virtual machine must be stop-deallocated before invoking this operation.",
+        "description": "Converts virtual machine disks from blob-based to managed disks. Virtual machine must be stop-deallocated before invoking this operation. <br>For Windows, please refer to [Convert a virtual machine from unmanaged disks to managed disks.](https://docs.microsoft.com/en-us/azure/virtual-machines/windows/convert-unmanaged-to-managed-disks).<br>For Linux, please refer to [Convert a virtual machine from unmanaged disks to managed disks.](https://docs.microsoft.com/en-us/azure/virtual-machines/linux/convert-unmanaged-to-managed-disks).",
         "parameters": [
           {
             "name": "resourceGroupName",
@@ -2925,6 +2925,11 @@
             "description": "Accepted"
           }
         },
+        "x-ms-examples": {
+          "Generalize a Virtual Machine.": {
+            "$ref": "./examples/ConvertToManagedDisks.json"
+          }
+        },
         "x-ms-long-running-operation": true
       }
     },
@@ -3405,7 +3410,7 @@
           "VirtualMachines"
         ],
         "operationId": "VirtualMachines_PerformMaintenance",
-        "description": "The operation to perform maintenance on a virtual machine.",
+        "description": "Shuts down the virtual machine, moves it to an already updated node, and powers it back on during the self-service phase of planned maintenance.",
         "parameters": [
           {
             "name": "resourceGroupName",
@@ -5901,7 +5906,7 @@
           "VirtualMachineScaleSetVMs"
         ],
         "operationId": "VirtualMachineScaleSetVMs_PerformMaintenance",
-        "description": "Performs maintenance on a virtual machine in a VM scale set.",
+        "description": "Shuts down the virtual machine in a VMScaleSet, moves it to an already updated node, and powers it back on during the self-service phase of planned maintenance.",
         "parameters": [
           {
             "name": "resourceGroupName",

specification/compute/resource-manager/Microsoft.Compute/stable/2019-12-01/examples/ConvertToManagedDisks.json

@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2019-12-01",
+    "vmName": "myVMName"
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}