diff --git a/arm-servicebus/2015-08-01/swagger/servicebus.json b/arm-servicebus/2015-08-01/swagger/servicebus.json
index 436b942c632d7..57fcba3530905 100644
--- a/arm-servicebus/2015-08-01/swagger/servicebus.json
+++ b/arm-servicebus/2015-08-01/swagger/servicebus.json
@@ -42,7 +42,7 @@
           "Namespaces"
         ],
         "operationId": "Namespaces_ListBySubscription",
-        "description": "Lists all the available namespaces within the subscription irrespective of the resourceGroups.",
+        "description": "Gets all the available namespaces within the subscription, irrespective of the resource groups.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt639412.aspx"
         },
@@ -56,7 +56,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Namespaces returned successfully",
+            "description": "Namespaces successfully returned.",
             "schema": {
               "$ref": "#/definitions/NamespaceListResult"
             }
@@ -73,7 +73,7 @@
           "Namespaces"
         ],
         "operationId": "Namespaces_ListByResourceGroup",
-        "description": "Lists the available namespaces within a resourceGroup.",
+        "description": "Gets the available namespaces within a resource group.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt639412.aspx"
         },
@@ -94,7 +94,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Namespaces returned successfully",
+            "description": "Namespaces successfully returned.",
             "schema": {
               "$ref": "#/definitions/NamespaceListResult"
             }
@@ -111,7 +111,7 @@
           "Namespaces"
         ],
         "operationId": "Namespaces_CreateOrUpdate",
-        "description": "Creates/Updates a service namespace. Once created, this namespace's resource manifest is immutable. This operation is idempotent.",
+        "description": "Creates or updates a service namespace. Once created, this namespace's resource manifest is immutable. This operation is idempotent.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt639408.aspx"
         },
@@ -137,7 +137,7 @@
             "schema": {
               "$ref": "#/definitions/NamespaceCreateOrUpdateParameters"
             },
-            "description": "Parameters supplied to create a Namespace Resource."
+            "description": "Parameters supplied to create a namespace resource."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -148,13 +148,13 @@
         ],
         "responses": {
           "201": {
-            "description": "Namespace create request accepted",
+            "description": "Namespace create request accepted.",
             "schema": {
               "$ref": "#/definitions/NamespaceResource"
             }
           },
           "200": {
-            "description": "Namespace create request successful",
+            "description": "Namespace created successfully.",
             "schema": {
               "$ref": "#/definitions/NamespaceResource"
             }
@@ -195,13 +195,13 @@
         ],
         "responses": {
           "204": {
-            "description": "No Content"
+            "description": "No content."
           },
           "200": {
-            "description": "Namespace delete successful"
+            "description": "Namespace successfully deleted."
           },
           "202": {
-            "description": "Namespace delete request has been accepted"
+            "description": "Namespace delete request accepted."
           }
         },
         "x-ms-long-running-operation": true
@@ -211,7 +211,7 @@
           "Namespaces"
         ],
         "operationId": "Namespaces_Get",
-        "description": "Returns the description for the specified namespace.",
+        "description": "Gets a description for the specified namespace.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt639379.aspx"
         },
@@ -239,7 +239,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Namespace returned successfully",
+            "description": "Namespace successfully returned.",
             "schema": {
               "$ref": "#/definitions/NamespaceResource"
             }
@@ -253,7 +253,7 @@
           "Namespaces"
         ],
         "operationId": "Namespaces_ListAuthorizationRules",
-        "description": "Authorization rules for a namespace.",
+        "description": "Gets the authorization rules for a namespace.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt639376.aspx"
         },
@@ -270,7 +270,7 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The namespace name"
+            "description": "The namespace name."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -281,7 +281,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Namespace Authorization rule returned successfully",
+            "description": "Namespace authorization rules returned successfully.",
             "schema": {
               "$ref": "#/definitions/SharedAccessAuthorizationRuleListResult"
             }
@@ -298,7 +298,7 @@
           "Namespaces"
         ],
         "operationId": "Namespaces_CreateOrUpdateAuthorizationRule",
-        "description": "Creates an authorization rule for a namespace",
+        "description": "Creates or updates an authorization rule for a namespace.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt639410.aspx"
         },
@@ -322,7 +322,7 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "Namespace Aauthorization Rule Name."
+            "description": "Namespace authorization rule name."
           },
           {
             "name": "parameters",
@@ -342,7 +342,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Namespace Authorization rule created",
+            "description": "Namespace authorization rule created.",
             "schema": {
               "$ref": "#/definitions/SharedAccessAuthorizationRuleResource"
             }
@@ -354,7 +354,7 @@
           "Namespaces"
         ],
         "operationId": "Namespaces_DeleteAuthorizationRule",
-        "description": "Deletes a namespace authorization rule",
+        "description": "Deletes a namespace authorization rule.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt639417.aspx"
         },
@@ -378,7 +378,7 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "Authorization Rule Name."
+            "description": "Authorization rule name."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -389,10 +389,10 @@
         ],
         "responses": {
           "204": {
-            "description": "No Content"
+            "description": "No content."
           },
           "200": {
-            "description": "Namespace Authorization rule deleted"
+            "description": "Namespace authorization rule successfully deleted."
           }
         }
       },
@@ -401,7 +401,7 @@
           "Namespaces"
         ],
         "operationId": "Namespaces_GetAuthorizationRule",
-        "description": "Authorization rule for a namespace by name.",
+        "description": "Gets an authorization rule for a namespace by rule name.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt639392.aspx"
         },
@@ -418,7 +418,7 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The namespace name"
+            "description": "The namespace name."
           },
           {
             "name": "authorizationRuleName",
@@ -436,7 +436,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Namespace Authorization rule returned successfully",
+            "description": "Namespace authorization rule returned successfully.",
             "schema": {
               "$ref": "#/definitions/SharedAccessAuthorizationRuleResource"
             }
@@ -450,7 +450,7 @@
           "Namespaces"
         ],
         "operationId": "Namespaces_ListKeys",
-        "description": "Primary and Secondary ConnectionStrings to the namespace ",
+        "description": "Gets the primary and secondary connection strings for the namespace.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt639398.aspx"
         },
@@ -474,7 +474,7 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The authorizationRule name."
+            "description": "The authorization rule name."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -485,7 +485,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Successful",
+            "description": "Connection strings successfully returned.",
             "schema": {
               "$ref": "#/definitions/ResourceListKeys"
             }
@@ -499,7 +499,7 @@
           "Namespaces"
         ],
         "operationId": "Namespaces_RegenerateKeys",
-        "description": "Regenerats the Primary or Secondary ConnectionStrings to the namespace ",
+        "description": "Regenerates the primary or secondary connection strings for the namespace.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt718977.aspx"
         },
@@ -523,7 +523,7 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The authorizationRule name."
+            "description": "The authorization rule name."
           },
           {
             "name": "parameters",
@@ -532,7 +532,7 @@
             "schema": {
               "$ref": "#/definitions/RegenerateKeysParameters"
             },
-            "description": "Parameters supplied to regenerate Auth Rule."
+            "description": "Parameters supplied to regenerate the authorization rule."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -543,7 +543,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Successful",
+            "description": "Authorization rule successfully regenerated.",
             "schema": {
               "$ref": "#/definitions/ResourceListKeys"
             }
@@ -557,7 +557,7 @@
           "Queues"
         ],
         "operationId": "Queues_ListAll",
-        "description": "Lists the queues within the namespace.",
+        "description": "Gets the queues within a namespace.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt639415.aspx"
         },
@@ -585,7 +585,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Queues returned successfully",
+            "description": "Queues successfully returned.",
             "schema": {
               "$ref": "#/definitions/QueueListResult"
             }
@@ -602,7 +602,7 @@
           "Queues"
         ],
         "operationId": "Queues_CreateOrUpdate",
-        "description": "Creates/Updates a service Queue. This operation is idempotent.",
+        "description": "Creates or updates a Service Bus queue. This operation is idempotent.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt639395.aspx"
         },
@@ -635,7 +635,7 @@
             "schema": {
               "$ref": "#/definitions/QueueCreateOrUpdateParameters"
             },
-            "description": "Parameters supplied to create a Queue Resource."
+            "description": "Parameters supplied to create or update a queue resource."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -646,7 +646,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Queue created",
+            "description": "Queue successfully created.",
             "schema": {
               "$ref": "#/definitions/QueueResource"
             }
@@ -658,7 +658,7 @@
           "Queues"
         ],
         "operationId": "Queues_Delete",
-        "description": "Deletes a queue from the specified namespace in resource group.",
+        "description": "Deletes a queue from the specified namespace in a resource group.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt639411.aspx"
         },
@@ -682,7 +682,7 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The queue name."
+            "description": "The name of the queue to be deleted."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -693,10 +693,10 @@
         ],
         "responses": {
           "204": {
-            "description": "No Content"
+            "description": "No content."
           },
           "200": {
-            "description": "Queue deleted."
+            "description": "Queue successfully deleted."
           }
         }
       },
@@ -705,7 +705,7 @@
           "Queues"
         ],
         "operationId": "Queues_Get",
-        "description": "Returns the description for the specified queue.",
+        "description": "Returns a description for the specified queue.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt639380.aspx"
         },
@@ -740,7 +740,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Successfully retrieved queue description.",
+            "description": "Queue description successfully returned.",
             "schema": {
               "$ref": "#/definitions/QueueResource"
             }
@@ -754,7 +754,7 @@
           "Queues"
         ],
         "operationId": "Queues_ListAuthorizationRules",
-        "description": "Returns all Queue authorizationRules.",
+        "description": "Gets all authorization rules for a queue.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt705607.aspx"
         },
@@ -789,7 +789,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Queues Authorization rule returned successfully",
+            "description": "Authorization rules successfully returned.",
             "schema": {
               "$ref": "#/definitions/SharedAccessAuthorizationRuleListResult"
             }
@@ -806,7 +806,7 @@
           "Queues"
         ],
         "operationId": "Queues_CreateOrUpdateAuthorizationRule",
-        "description": "Creates an authorization rule for a queue",
+        "description": "Creates an authorization rule for a queue.",
         "parameters": [
           {
             "name": "resourceGroupName",
@@ -834,7 +834,7 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "Aauthorization Rule Name."
+            "description": "Authorization rule name."
           },
           {
             "name": "parameters",
@@ -854,7 +854,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Queues Authorization rule created",
+            "description": "Authorization rule successfully created.",
             "schema": {
               "$ref": "#/definitions/SharedAccessAuthorizationRuleResource"
             }
@@ -866,7 +866,7 @@
           "Queues"
         ],
         "operationId": "Queues_DeleteAuthorizationRule",
-        "description": "Deletes a queue authorization rule",
+        "description": "Deletes a queue authorization rule.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt705609.aspx"
         },
@@ -897,7 +897,7 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "Authorization Rule Name."
+            "description": "Authorization rule name."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -908,10 +908,10 @@
         ],
         "responses": {
           "204": {
-            "description": "No Content"
+            "description": "No content."
           },
           "200": {
-            "description": "Queue authorizationRule deleted"
+            "description": "Authorization rule successfully deleted."
           }
         }
       },
@@ -920,7 +920,7 @@
           "Queues"
         ],
         "operationId": "Queues_GetAuthorizationRule",
-        "description": "Queue authorizationRule for a queue by name.",
+        "description": "Gets an authorization rule for a queue by rule name.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt705611.aspx"
         },
@@ -937,7 +937,7 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The namespace name"
+            "description": "The namespace name."
           },
           {
             "name": "queueName",
@@ -962,7 +962,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Queues AuthorizationRule returned successfully",
+            "description": "Authorization rule successfully returned.",
             "schema": {
               "$ref": "#/definitions/SharedAccessAuthorizationRuleResource"
             }
@@ -976,7 +976,7 @@
           "Queues"
         ],
         "operationId": "Queues_ListKeys",
-        "description": "Primary and Secondary ConnectionStrings to the queue.",
+        "description": "Primary and secondary connection strings to the queue.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt705608.aspx"
         },
@@ -1007,7 +1007,7 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The authorizationRule name."
+            "description": "The authorization rule name."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -1018,7 +1018,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Successful",
+            "description": "Connection strings successfully returned.",
             "schema": {
               "$ref": "#/definitions/ResourceListKeys"
             }
@@ -1032,7 +1032,7 @@
           "Queues"
         ],
         "operationId": "Queues_RegenerateKeys",
-        "description": "Regenerates the Primary or Secondary ConnectionStrings to the Queue",
+        "description": "Regenerates the primary or secondary connection strings to the queue.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt705606.aspx"
         },
@@ -1063,7 +1063,7 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The authorizationRule name"
+            "description": "The authorization rule name."
           },
           {
             "name": "parameters",
@@ -1072,7 +1072,7 @@
             "schema": {
               "$ref": "#/definitions/RegenerateKeysParameters"
             },
-            "description": "Parameters supplied to regenerate Auth Rule."
+            "description": "Parameters supplied to regenerate the authorization rule."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -1083,7 +1083,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Successful",
+            "description": "Connection strings successfully regenerated.",
             "schema": {
               "$ref": "#/definitions/ResourceListKeys"
             }
@@ -1097,7 +1097,7 @@
           "Topics"
         ],
         "operationId": "Topics_ListAll",
-        "description": "Lists all the topics in a namespace.",
+        "description": "Gets all the topics in a namespace.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt639388.aspx"
         },
@@ -1142,7 +1142,7 @@
           "Topics"
         ],
         "operationId": "Topics_CreateOrUpdate",
-        "description": "Creates a topic in the specified namespace",
+        "description": "Creates a topic in the specified namespace.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt639409.aspx"
         },
@@ -1175,7 +1175,7 @@
             "schema": {
               "$ref": "#/definitions/TopicCreateOrUpdateParameters"
             },
-            "description": "Parameters supplied to create a Topic Resource."
+            "description": "Parameters supplied to create a topic resource."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -1186,7 +1186,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Topic created",
+            "description": "Topic successfully created.",
             "schema": {
               "$ref": "#/definitions/TopicResource"
             }
@@ -1215,14 +1215,14 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The topics name."
+            "description": "The namespace name."
           },
           {
             "name": "topicName",
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The topics name."
+            "description": "The name of the topic to delete."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -1236,7 +1236,7 @@
             "description": "No Content"
           },
           "200": {
-            "description": "Topic delete successful"
+            "description": "Topic successfully deleted."
           }
         }
       },
@@ -1245,7 +1245,7 @@
           "Topics"
         ],
         "operationId": "Topics_Get",
-        "description": "Returns the description for the specified topic",
+        "description": "Returns a description for the specified topic.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt639399.aspx"
         },
@@ -1280,7 +1280,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Successfully retrieved topic description.",
+            "description": "Topic description successfully retrieved.",
             "schema": {
               "$ref": "#/definitions/TopicResource"
             }
@@ -1294,7 +1294,7 @@
           "Topics"
         ],
         "operationId": "Topics_ListAuthorizationRules",
-        "description": "Authorization rules for a topic.",
+        "description": "Gets authorization rules for a topic.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt720681.aspx"
         },
@@ -1311,7 +1311,7 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The topic name"
+            "description": "The namespace name."
           },
           {
             "name": "topicName",
@@ -1329,7 +1329,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Topic AuthorizationRule returned successfully",
+            "description": "Authorization rules successfully returned.",
             "schema": {
               "$ref": "#/definitions/SharedAccessAuthorizationRuleListResult"
             }
@@ -1346,7 +1346,7 @@
           "Topics"
         ],
         "operationId": "Topics_CreateOrUpdateAuthorizationRule",
-        "description": "Creates an authorizatioRule for the specified topic.",
+        "description": "Creates an authorizatio rule for the specified topic.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt720678.aspx"
         },
@@ -1377,7 +1377,7 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "Aauthorization Rule Name."
+            "description": "Authorization rule name."
           },
           {
             "name": "parameters",
@@ -1397,7 +1397,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Topic Authorization rule created",
+            "description": "Topic authorization rule successfully created.",
             "schema": {
               "$ref": "#/definitions/SharedAccessAuthorizationRuleResource"
             }
@@ -1409,7 +1409,7 @@
           "Topics"
         ],
         "operationId": "Topics_GetAuthorizationRule",
-        "description": "Returns the specified authorizationRule.",
+        "description": "Returns the specified authorization rule.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt720676.aspx"
         },
@@ -1426,7 +1426,7 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The namespace name"
+            "description": "The namespace name."
           },
           {
             "name": "topicName",
@@ -1451,7 +1451,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Topic AuthorizationRule returned successfully",
+            "description": "Topic authorization rule returned successfully.",
             "schema": {
               "$ref": "#/definitions/SharedAccessAuthorizationRuleResource"
             }
@@ -1463,7 +1463,7 @@
           "Topics"
         ],
         "operationId": "Topics_DeleteAuthorizationRule",
-        "description": "Deletes a topic authorizationRule",
+        "description": "Deletes a topic authorization rule.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt720681.aspx"
         },
@@ -1494,7 +1494,7 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "AuthorizationRule Name."
+            "description": "Authorization rule name."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -1505,10 +1505,10 @@
         ],
         "responses": {
           "204": {
-            "description": "No Content"
+            "description": "No content."
           },
           "200": {
-            "description": "Topics AuthorizationRule deleted"
+            "description": "Topic authorization rule successfully deleted."
           }
         }
       }
@@ -1519,7 +1519,7 @@
           "Topics"
         ],
         "operationId": "Topics_ListKeys",
-        "description": "Primary and Secondary ConnectionStrings to the topic",
+        "description": "Gets the primary and secondary connection strings for the topic.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt720677.aspx"
         },
@@ -1550,7 +1550,7 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The authorizationRule name."
+            "description": "The authorization rule name."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -1561,7 +1561,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Successful",
+            "description": "Connection strings successfully retrieved.",
             "schema": {
               "$ref": "#/definitions/ResourceListKeys"
             }
@@ -1575,7 +1575,7 @@
           "Topics"
         ],
         "operationId": "Topics_RegenerateKeys",
-        "description": "Regenerates Primary or Secondary ConnectionStrings to the topic",
+        "description": "Regenerates primary or secondary connection strings for the topic.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt720679.aspx"
         },
@@ -1606,7 +1606,7 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The authorizationRule name."
+            "description": "The authorization rule name."
           },
           {
             "name": "parameters",
@@ -1615,7 +1615,7 @@
             "schema": {
               "$ref": "#/definitions/RegenerateKeysParameters"
             },
-            "description": "Parameters supplied to regenerate Auth Rule."
+            "description": "Parameters supplied to regenerate the authorization rule."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -1626,7 +1626,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Successful",
+            "description": "Connection strings successfully regenerated.",
             "schema": {
               "$ref": "#/definitions/ResourceListKeys"
             }
@@ -1640,7 +1640,7 @@
           "Subscriptions"
         ],
         "operationId": "Subscriptions_ListAll",
-        "description": "Lsit all the subscriptions under a specified topic",
+        "description": "Lsit all the subscriptions under a specified topic.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt639400.aspx"
         },
@@ -1675,7 +1675,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Successfully retrieved list of Subscriptions.",
+            "description": "Successfully retrieved list of subscriptions.",
             "schema": {
               "$ref": "#/definitions/SubscriptionListResult"
             }
@@ -1692,7 +1692,7 @@
           "Subscriptions"
         ],
         "operationId": "Subscriptions_CreateOrUpdate",
-        "description": "Creates a topic subscription",
+        "description": "Creates a topic subscription.",
         "externalDocs": {
           "url": "https://msdn.microsoft.com/en-us/library/azure/mt639385.aspx"
         },
@@ -1716,14 +1716,14 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The topicName name."
+            "description": "The topic name."
           },
           {
             "name": "subscriptionName",
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The subscriptionName name."
+            "description": "The subscription name."
           },
           {
             "name": "parameters",
@@ -1732,7 +1732,7 @@
             "schema": {
               "$ref": "#/definitions/SubscriptionCreateOrUpdateParameters"
             },
-            "description": "Parameters supplied to create a subscription Resource."
+            "description": "Parameters supplied to create a subscription resource."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -1743,7 +1743,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Subscription create request accepted",
+            "description": "Subscription create request accepted.",
             "schema": {
               "$ref": "#/definitions/SubscriptionResource"
             }
@@ -1797,10 +1797,10 @@
         ],
         "responses": {
           "204": {
-            "description": "No Content"
+            "description": "No content."
           },
           "200": {
-            "description": "Subscription deleted."
+            "description": "Subscription successfully deleted."
           }
         }
       },
@@ -1851,7 +1851,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Successfully retrieved queue description.",
+            "description": "Successfully retrieved subscription description.",
             "schema": {
               "$ref": "#/definitions/SubscriptionResource"
             }
@@ -1919,7 +1919,7 @@
       "required": [
         "location"
       ],
-      "description": "Parameters supplied to the CreateOrUpdate Namespace operation."
+      "description": "Parameters supplied to the Create Or Update Namespace operation."
     },
     "NamespaceListResult": {
       "properties": {
@@ -1932,7 +1932,7 @@
         },
         "nextLink": {
           "type": "string",
-          "description": "Link to the next set of results. Not empty if Value contains incomplete list of Namespaces"
+          "description": "Link to the next set of results. Not empty if Value contains incomplete list of Namespaces."
         }
       },
       "description": "The response of the List Namespace operation."
@@ -1952,13 +1952,13 @@
           "$ref": "#/definitions/Resource"
         }
       ],
-      "description": "Description of a Namespace resource."
+      "description": "Description of a namespace resource."
     },
     "NamespaceProperties": {
       "properties": {
         "provisioningState": {
           "type": "string",
-          "description": "Provisioning state of the Namespace."
+          "description": "Provisioning state of the namespace."
         },
         "status": {
           "type": "string",
@@ -1998,25 +1998,25 @@
             "url": "http://msdn.microsoft.com/en-us/library/windowsazure/jj873988.aspx"
           },
           "type": "string",
-          "description": "Endpoint you can use to perform ServiceBus operations."
+          "description": "Endpoint you can use to perform Service Bus operations."
         },
         "createACSNamespace": {
           "type": "boolean",
-          "description": "Indicates whether to create ACS namespace."
+          "description": "Indicates whether to create an ACS namespace."
         },
         "enabled": {
           "type": "boolean",
           "description": "Specifies whether this instance is enabled."
         }
       },
-      "description": "Properties of the Namespace."
+      "description": "Properties of the namespace."
     },
     "Sku": {
       "type": "object",
       "properties": {
         "name": {
           "type": "string",
-          "description": "Name of this Sku",
+          "description": "Name of this SKU.",
           "enum": [
             "Basic",
             "Standard",
@@ -2029,7 +2029,7 @@
         },
         "tier": {
           "type": "string",
-          "description": "The tier of this particular SKU",
+          "description": "The billing tier of this particular SKU.",
           "enum": [
             "Basic",
             "Standard",
@@ -2043,13 +2043,13 @@
         "capacity": {
           "format": "int32",
           "type": "integer",
-          "description": "The messaging units for the tier specified"
+          "description": "The specified messaging units for the tier."
         }
       },
       "required": [
         "tier"
       ],
-      "description": "Sku of the Namespace."
+      "description": "SKU of the namespace."
     },
     "SharedAccessAuthorizationRuleCreateOrUpdateParameters": {
       "properties": {
@@ -2059,14 +2059,14 @@
         },
         "name": {
           "type": "string",
-          "description": "Name of the AuthorizationRule."
+          "description": "Name of the authorization rule."
         },
         "properties": {
           "x-ms-client-flatten": true,
           "$ref": "#/definitions/SharedAccessAuthorizationRuleProperties"
         }
       },
-      "description": "Parameters supplied to the CreateOrUpdate  AuthorizationRules."
+      "description": "Parameters supplied to the Create Or Update Authorization Rules operation."
     },
     "SharedAccessAuthorizationRuleListResult": {
       "properties": {
@@ -2075,14 +2075,14 @@
           "items": {
             "$ref": "#/definitions/SharedAccessAuthorizationRuleResource"
           },
-          "description": "Result of the List AuthorizationRules operation."
+          "description": "Result of the List Authorization Rules operation."
         },
         "nextLink": {
           "type": "string",
-          "description": "Link to the next set of results. Not empty if Value contains incomplete list of AuthorizationRules"
+          "description": "Link to the next set of results. Not empty if Value contains incomplete list of Authorization Rules."
         }
       },
-      "description": "The response of the List Namespace operation."
+      "description": "The response to the List Namespace operation."
     },
     "SharedAccessAuthorizationRuleResource": {
       "properties": {
@@ -2096,7 +2096,7 @@
           "$ref": "#/definitions/Resource"
         }
       ],
-      "description": "Description of a Namespace AuthorizationRules."
+      "description": "Description of a namespace authorization rule."
     },
     "SharedAccessAuthorizationRuleProperties": {
       "properties": {
@@ -2126,23 +2126,23 @@
       "properties": {
         "primaryConnectionString": {
           "type": "string",
-          "description": "PrimaryConnectionString of the created Namespace AuthorizationRule."
+          "description": "Primary connection string of the created namespace authorization rule."
         },
         "secondaryConnectionString": {
           "type": "string",
-          "description": "SecondaryConnectionString of the created Namespace AuthorizationRule"
+          "description": "Secondary connection string of the created namespace authorization rule."
         },
         "primaryKey": {
           "type": "string",
-          "description": "A base64-encoded 256-bit primary key for signing and validating the SAS token"
+          "description": "A base64-encoded 256-bit primary key for signing and validating the SAS token."
         },
         "secondaryKey": {
           "type": "string",
-          "description": "A base64-encoded 256-bit primary key for signing and validating the SAS token"
+          "description": "A base64-encoded 256-bit primary key for signing and validating the SAS token."
         },
         "keyName": {
           "type": "string",
-          "description": "A string that describes the authorization rule"
+          "description": "A string that describes the authorization rule."
         }
       },
       "description": "Namespace/ServiceBus Connection String"
@@ -2151,7 +2151,7 @@
       "properties": {
         "Policykey": {
           "type": "string",
-          "description": "Key that needs to be regenerated .",
+          "description": "Key that needs to be regenerated.",
           "enum": [
             "PrimaryKey",
             "SecondaryKey"
@@ -2162,7 +2162,7 @@
           }
         }
       },
-      "description": "Parameters supplied to the Regenerate Auth Rule."
+      "description": "Parameters supplied to the Regenerate Authorization Rule operation."
     },
     "QueueCreateOrUpdateParameters": {
       "properties": {
@@ -2182,7 +2182,7 @@
       "required": [
         "location"
       ],
-      "description": "Parameters supplied to the CreateOrUpdate Queue operation."
+      "description": "Parameters supplied to the Create Or Update Queue operation."
     },
     "QueueListResult": {
       "properties": {
@@ -2195,10 +2195,10 @@
         },
         "nextLink": {
           "type": "string",
-          "description": "Link to the next set of results. Not empty if Value contains incomplete list of Queues"
+          "description": "Link to the next set of results. Not empty if Value contains incomplete list of queues."
         }
       },
-      "description": "The response of the List Queues operation."
+      "description": "The response to the List Queues operation."
     },
     "QueueResource": {
       "properties": {
@@ -2218,7 +2218,7 @@
       "properties": {
         "lockDuration ": {
           "type": "string",
-          "description": "the duration of a peek lock; that is, the amount of time that the message is locked for other receivers. The maximum value for LockDuration is 5 minutes; the default value is 1 minute."
+          "description": "The duration of a peek-lock; that is, the amount of time that the message is locked for other receivers. The maximum value for LockDuration is 5 minutes; the default value is 1 minute."
         },
         "accessedAt": {
           "type": "string",
@@ -2236,66 +2236,66 @@
         "createdAt": {
           "type": "string",
           "format": "date-time",
-          "description": "the exact time the message was created."
+          "description": "The exact time the message was created."
         },
         "defaultMessageTimeToLive": {
           "type": "string",
-          "description": "the default message time to live value. This is the duration after which the message expires, starting from when the message is sent to Service Bus. This is the default value used when TimeToLive is not set on a message itself."
+          "description": "The default message time to live value. This is the duration after which the message expires, starting from when the message is sent to Service Bus. This is the default value used when TimeToLive is not set on a message itself."
         },
         "duplicateDetectionHistoryTimeWindow ": {
           "type": "string",
-          "description": "TimeSpan structure that defines the duration of the duplicate detection history. The default value is 10 minutes.."
+          "description": "TimeSpan structure that defines the duration of the duplicate detection history. The default value is 10 minutes."
         },
         "enableBatchedOperations": {
           "type": "boolean",
-          "description": "value that indicates whether server-side batched operations are enabled.."
+          "description": "A value that indicates whether server-side batched operations are enabled."
         },
         "deadLetteringOnMessageExpiration": {
           "type": "boolean",
-          "description": "a value that indicates whether this queue has dead letter support when a message expires."
+          "description": "A value that indicates whether this queue has dead letter support when a message expires."
         },
         "enableExpress": {
           "type": "boolean",
-          "description": "a value that indicates whether Express Entities are enabled. An express queue holds a message in memory temporarily before writing it to persistent storage."
+          "description": "A value that indicates whether Express Entities are enabled. An express queue holds a message in memory temporarily before writing it to persistent storage."
         },
         "enablePartitioning": {
           "type": "boolean",
-          "description": "value that indicates whether the queue to be partitioned across multiple message brokers is enabled."
+          "description": "A value that indicates whether the queue is to be partitioned across multiple message brokers."
         },
         "isAnonymousAccessible": {
           "type": "boolean",
-          "description": "a value that indicates whether the message is anonymous accessible."
+          "description": "A value that indicates whether the message is accessible anonymously."
         },
         "maxDeliveryCount ": {
           "format": "int32",
           "type": "integer",
-          "description": "the maximum delivery count. A message is automatically deadlettered after this number of deliveries."
+          "description": "The maximum delivery count. A message is automatically deadlettered after this number of deliveries."
         },
         "maxSizeInMegabytes": {
           "format": "int64",
           "type": "integer",
-          "description": "the maximum size of the queue in megabytes, which is the size of memory allocated for the queue."
+          "description": "The maximum size of the queue in megabytes, which is the size of memory allocated for the queue."
         },
         "messageCount ": {
           "format": "int64",
           "type": "integer",
-          "description": "the number of messages in the queue."
+          "description": "The number of messages in the queue."
         },
         "countDetails": {
           "$ref": "#/definitions/MessageCountDetails"
         },
         "requiresDuplicateDetection": {
           "type": "boolean",
-          "description": "the value indicating if this queue requires duplicate detection."
+          "description": "A value indicating if this queue requires duplicate detection."
         },
         "requiresSession": {
           "type": "boolean",
-          "description": "a value that indicates whether the queue supports the concept of session."
+          "description": "A value that indicates whether the queue supports the concept of sessions."
         },
         "sizeInBytes ": {
           "format": "int64",
           "type": "integer",
-          "description": "the size of the queue in bytes."
+          "description": "The size of the queue, in bytes."
         },
         "status": {
           "$ref": "#/definitions/EntityStatus",
@@ -2303,12 +2303,12 @@
         },
         "supportOrdering": {
           "type": "boolean",
-          "description": "a value that indicates whether the queue supports ordering."
+          "description": "A value that indicates whether the queue supports ordering."
         },
         "updatedAt": {
           "type": "string",
           "format": "date-time",
-          "description": "the exact time the message has been updated."
+          "description": "The exact time the message was updated."
         }
       }
     },
@@ -2323,12 +2323,12 @@
         "deadLetterMessageCount": {
           "format": "int64",
           "type": "integer",
-          "description": "Number of messages that are dead letters."
+          "description": "Number of messages that are dead lettered."
         },
         "scheduledMessageCount": {
           "format": "int64",
           "type": "integer",
-          "description": "Number scheduled messages."
+          "description": "Number of scheduled messages."
         },
         "transferDeadLetterMessageCount": {
           "format": "int64",
@@ -2361,7 +2361,7 @@
       "required": [
         "location"
       ],
-      "description": "Parameters supplied to the CreateOrUpdate Topic operation."
+      "description": "Parameters supplied to the Create Or Update Topic operation."
     },
     "TopicListResult": {
       "properties": {
@@ -2374,10 +2374,10 @@
         },
         "nextLink": {
           "type": "string",
-          "description": "Link to the next set of results. Not empty if Value contains incomplete list of Topics"
+          "description": "Link to the next set of results. Not empty if Value contains incomplete list of topics."
         }
       },
-      "description": "The response of the List Topics operation."
+      "description": "The response to the List Topics operation."
     },
     "TopicResource": {
       "properties": {
@@ -2391,14 +2391,14 @@
           "$ref": "#/definitions/Resource"
         }
       ],
-      "description": "Description of topic Resource."
+      "description": "Description of topic resource."
     },
     "TopicProperties": {
       "properties": {
         "accessedAt": {
           "type": "string",
           "format": "date-time",
-          "description": "Last time the message was sent or a request was received for this topic."
+          "description": "Last time the message was sent, or a request was received, for this topic."
         },
         "autoDeleteOnIdle": {
           "type": "string",
@@ -2422,11 +2422,11 @@
         },
         "duplicateDetectionHistoryTimeWindow ": {
           "type": "string",
-          "description": "TimeSpan structure that defines the duration of the duplicate detection history. The default value is 10 minutes.."
+          "description": "TimeSpan structure that defines the duration of the duplicate detection history. The default value is 10 minutes."
         },
         "enableBatchedOperations": {
           "type": "boolean",
-          "description": "Value that indicates whether server-side batched operations are enabled.."
+          "description": "Value that indicates whether server-side batched operations are enabled."
         },
         "enableExpress": {
           "type": "boolean",
@@ -2438,7 +2438,7 @@
         },
         "enableSubscriptionPartitioning": {
           "type": "boolean",
-          "description": "Value that indicates whether partitioning is enabled or disabled.."
+          "description": "Value that indicates whether partitioning is enabled or disabled."
         },
         "filteringMessagesBeforePublishing": {
           "type": "boolean",
@@ -2446,7 +2446,7 @@
         },
         "isAnonymousAccessible": {
           "type": "boolean",
-          "description": "Value that indicates whether the message is anonymous accessible."
+          "description": "Value that indicates whether the message is accessible anonymously."
         },
         "isExpress": {
           "type": "boolean",
@@ -2455,7 +2455,7 @@
         "maxSizeInMegabytes": {
           "format": "int64",
           "type": "integer",
-          "description": "Maximum size of the topic in megabytes, which is the size of memory allocated for the topic."
+          "description": "Maximum size of the topic in megabytes, which is the size of the memory allocated for the topic."
         },
         "requiresDuplicateDetection": {
           "type": "boolean",
@@ -2464,7 +2464,7 @@
         "sizeInBytes": {
           "format": "int64",
           "type": "integer",
-          "description": "Size of the topic in bytes."
+          "description": "Size of the topic, in bytes."
         },
         "status": {
           "$ref": "#/definitions/EntityStatus",
@@ -2482,7 +2482,7 @@
         "updatedAt": {
           "type": "string",
           "format": "date-time",
-          "description": "The exact time the message has been updated."
+          "description": "The exact time the message was updated."
         }
       }
     },
@@ -2494,7 +2494,7 @@
         },
         "type": {
           "type": "string",
-          "description": "Resource Manager type of the resource."
+          "description": "Resource manager type of the resource."
         },
         "properties": {
           "x-ms-client-flatten": true,
@@ -2504,7 +2504,7 @@
       "required": [
         "location"
       ],
-      "description": "Parameters supplied to the CreateOrUpdate Subscription operation."
+      "description": "Parameters supplied to the Create Or Update Subscription operation."
     },
     "SubscriptionListResult": {
       "properties": {
@@ -2517,10 +2517,10 @@
         },
         "nextLink": {
           "type": "string",
-          "description": "Link to the next set of results. Not empty if Value contains incomplete list of Subscriptions"
+          "description": "Link to the next set of results. Not empty if Value contains incomplete list of subscriptions."
         }
       },
-      "description": "The response of the List Subscriptions operation."
+      "description": "The response to the List Subscriptions operation."
     },
     "SubscriptionResource": {
       "properties": {
@@ -2534,14 +2534,14 @@
           "$ref": "#/definitions/Resource"
         }
       ],
-      "description": "Description of Subscription Resource."
+      "description": "Description of subscription resource."
     },
     "SubscriptionProperties": {
       "properties": {
         "accessedAt": {
           "type": "string",
           "format": "date-time",
-          "description": "Last time a there was a receive request to this subscription."
+          "description": "Last time there was a receive request to this subscription."
         },
         "autoDeleteOnIdle": {
           "type": "string",
@@ -2561,15 +2561,15 @@
         },
         "deadLetteringOnFilterEvaluationExceptions": {
           "type": "boolean",
-          "description": "Value that indicates if a subscription has dead letter support on Filter evaluation exceptions."
+          "description": "Value that indicates whether a subscription has dead letter support on filter evaluation exceptions."
         },
         "deadLetteringOnMessageExpiration": {
           "type": "boolean",
-          "description": "Value that indicates if a subscription has dead letter support when a message expires."
+          "description": "Value that indicates whether a subscription has dead letter support when a message expires."
         },
         "enableBatchedOperations": {
           "type": "boolean",
-          "description": "Value that indicates whether server-side batched operations are enabled.."
+          "description": "Value that indicates whether server-side batched operations are enabled."
         },
         "entityAvailabilityStatus": {
           "$ref": "#/definitions/EntityAvailabilityStatus",
@@ -2595,7 +2595,7 @@
         },
         "requiresSession": {
           "type": "boolean",
-          "description": "Value indicating if a subscription supports the concept of session."
+          "description": "Value indicating if a subscription supports the concept of sessions."
         },
         "status": {
           "$ref": "#/definitions/EntityStatus",
@@ -2604,7 +2604,7 @@
         "updatedAt": {
           "type": "string",
           "format": "date-time",
-          "description": "The exact time the message has been updated."
+          "description": "The exact time the message was updated."
         }
       },
       "description": "Description of Subscription Resource."
@@ -2650,14 +2650,14 @@
       "in": "path",
       "required": true,
       "type": "string",
-      "description": "Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
+      "description": "Subscription credentials that uniquely identify a Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
     },
     "ApiVersionParameter": {
       "name": "api-version",
       "in": "query",
       "required": true,
       "type": "string",
-      "description": "Client Api Version."
+      "description": "Client API version."
     }
   }
 }
\ No newline at end of file