Sasolank/more review comments (#21025)

* XML

* proxy to gateway

Author: solankisamir

specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2022-04-01-preview/apimbackends.json

@@ -379,7 +379,7 @@
           "BackendReconnect"
         ],
         "operationId": "Backend_Reconnect",
-        "description": "Notifies the APIM proxy to create a new connection to the backend after the specified timeout. If no timeout was specified, timeout of 2 minutes is used.",
+        "description": "Notifies the API Management gateway to create a new connection to the backend after the specified timeout. If no timeout was specified, timeout of 2 minutes is used.",
         "x-ms-examples": {
           "ApiManagementBackendReconnect": {
             "$ref": "./examples/ApiManagementBackendReconnect.json"

specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2022-04-01-preview/apimdeployment.json

@@ -1026,7 +1026,7 @@
         },
         "defaultSslBinding": {
           "type": "boolean",
-          "description": "Specify true to setup the certificate associated with this Hostname as the Default SSL Certificate. If a client does not send the SNI header, then this will be the certificate that will be challenged. The property is useful if a service has multiple custom hostname enabled and it needs to decide on the default ssl certificate. The setting only applied to Proxy Hostname Type.",
+          "description": "Specify true to setup the certificate associated with this Hostname as the Default SSL Certificate. If a client does not send the SNI header, then this will be the certificate that will be challenged. The property is useful if a service has multiple custom hostname enabled and it needs to decide on the default ssl certificate. The setting only applied to gateway Hostname Type.",
           "default": false
         },
         "negotiateClientCertificate": {

specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2022-04-01-preview/apimdiagnostics.json

@@ -2,7 +2,7 @@
   "swagger": "2.0",
   "info": {
     "title": "ApiManagementClient",
-    "description": "Use these REST APIs for performing operations on Diagnostic entity associated with your Azure API Management deployment. Diagnostics are used to log requests/responses in the APIM proxy.",
+    "description": "Use these REST APIs for performing operations on Diagnostic entity associated with your Azure API Management deployment. Diagnostics are used to log requests/responses in the API Management proxy.",
     "version": "2022-04-01-preview"
   },
   "host": "management.azure.com",

specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2022-04-01-preview/definitions.json

@@ -1835,7 +1835,7 @@
         },
         "proxy": {
           "$ref": "#/definitions/BackendProxyContract",
-          "description": "Backend Proxy Contract Properties"
+          "description": "Backend gateway Contract Properties"
         },
         "tls": {
           "$ref": "#/definitions/BackendTlsProperties",
@@ -4282,7 +4282,7 @@
               },
               {
                 "value": "rawxml-link",
-                "description": "The policy document is not Xml encoded and is hosted on a http endpoint accessible from the API Management service."
+                "description": "The policy document is not XML encoded and is hosted on a http endpoint accessible from the API Management service."
               }
             ]
           },
@@ -4332,7 +4332,7 @@
           "items": {
             "$ref": "#/definitions/PolicyDescriptionContract"
           },
-          "description": "Descriptions of APIM policies."
+          "description": "Descriptions of API Management policies."
         },
         "count": {
           "type": "integer",
@@ -4341,7 +4341,7 @@
           "description": "Total record count number."
         }
       },
-      "description": "Descriptions of APIM policies."
+      "description": "Descriptions of API Management policies."
     },
     "PolicyFragmentCollection": {
       "type": "object",
@@ -4672,7 +4672,7 @@
           "items": {
             "$ref": "#/definitions/PortalSettingsContract"
           },
-          "description": "Descriptions of APIM policies."
+          "description": "Descriptions of API Management policies."
         },
         "count": {
           "type": "integer",
@@ -4681,7 +4681,7 @@
           "description": "Total record count number."
         }
       },
-      "description": "Descriptions of APIM policies."
+      "description": "Descriptions of API Management policies."
     },
     "PortalSettingsContract": {
       "properties": {
@@ -5399,7 +5399,7 @@
         "callCountFailed": {
           "type": "integer",
           "format": "int32",
-          "description": "Number of calls failed due to proxy or backend errors. This includes calls returning HttpStatusCode.BadRequest(400) and any Code between HttpStatusCode.InternalServerError (500) and 600"
+          "description": "Number of calls failed due to gateway or backend errors. This includes calls returning HttpStatusCode.BadRequest(400) and any Code between HttpStatusCode.InternalServerError (500) and 600"
         },
         "callCountOther": {
           "type": "integer",
@@ -5858,7 +5858,7 @@
             "values": [
               {
                 "value": "xml",
-                "description": "Xml schema type.",
+                "description": "XML schema type.",
                 "name": "Xml"
               },
               {