diff --git a/azure-mgmt-resources/src/main/java/com/microsoft/azure/management/resources/ErrorResponse.java b/azure-mgmt-resources/src/main/java/com/microsoft/azure/management/resources/ErrorResponse.java
index ccfedd308e1..be820afc43c 100644
--- a/azure-mgmt-resources/src/main/java/com/microsoft/azure/management/resources/ErrorResponse.java
+++ b/azure-mgmt-resources/src/main/java/com/microsoft/azure/management/resources/ErrorResponse.java
@@ -11,8 +11,8 @@
 import com.fasterxml.jackson.annotation.JsonProperty;
 
 /**
- * Error reponse indicates ARM is not able to process the incoming request. The
- * reason is provided in the error message.
+ * Error reponse indicates Azure Resource Manager is not able to process the
+ * incoming request. The reason is provided in the error message.
  */
 public class ErrorResponse {
     /**
diff --git a/azure-mgmt-resources/src/main/java/com/microsoft/azure/management/resources/PolicySku.java b/azure-mgmt-resources/src/main/java/com/microsoft/azure/management/resources/PolicySku.java
index de2b5969466..bb422d7f71e 100644
--- a/azure-mgmt-resources/src/main/java/com/microsoft/azure/management/resources/PolicySku.java
+++ b/azure-mgmt-resources/src/main/java/com/microsoft/azure/management/resources/PolicySku.java
@@ -11,7 +11,7 @@
 import com.fasterxml.jackson.annotation.JsonProperty;
 
 /**
- * The policy sku.
+ * The policy sku. This property is optional, obsolete, and will be ignored.
  */
 public class PolicySku {
     /**
diff --git a/azure-mgmt-resources/src/main/java/com/microsoft/azure/management/resources/implementation/PolicyAssignmentInner.java b/azure-mgmt-resources/src/main/java/com/microsoft/azure/management/resources/implementation/PolicyAssignmentInner.java
index 2479dcd5bd1..e5fd4f1565d 100644
--- a/azure-mgmt-resources/src/main/java/com/microsoft/azure/management/resources/implementation/PolicyAssignmentInner.java
+++ b/azure-mgmt-resources/src/main/java/com/microsoft/azure/management/resources/implementation/PolicyAssignmentInner.java
@@ -25,7 +25,7 @@ public class PolicyAssignmentInner {
     private String displayName;
 
     /**
-     * The ID of the policy definition.
+     * The ID of the policy definition or policy set definition being assigned.
      */
     @JsonProperty(value = "properties.policyDefinitionId")
     private String policyDefinitionId;
@@ -79,7 +79,8 @@ public class PolicyAssignmentInner {
     private String name;
 
     /**
-     * The policy sku.
+     * The policy sku. This property is optional, obsolete, and will be
+     * ignored.
      */
     @JsonProperty(value = "sku")
     private PolicySku sku;
@@ -105,7 +106,7 @@ public PolicyAssignmentInner withDisplayName(String displayName) {
     }
 
     /**
-     * Get the ID of the policy definition.
+     * Get the ID of the policy definition or policy set definition being assigned.
      *
      * @return the policyDefinitionId value
      */
@@ -114,7 +115,7 @@ public String policyDefinitionId() {
     }
 
     /**
-     * Set the ID of the policy definition.
+     * Set the ID of the policy definition or policy set definition being assigned.
      *
      * @param policyDefinitionId the policyDefinitionId value to set
      * @return the PolicyAssignmentInner object itself.
@@ -252,7 +253,7 @@ public String name() {
     }
 
     /**
-     * Get the policy sku.
+     * Get the policy sku. This property is optional, obsolete, and will be ignored.
      *
      * @return the sku value
      */
@@ -261,7 +262,7 @@ public PolicySku sku() {
     }
 
     /**
-     * Set the policy sku.
+     * Set the policy sku. This property is optional, obsolete, and will be ignored.
      *
      * @param sku the sku value to set
      * @return the PolicyAssignmentInner object itself.
diff --git a/azure-mgmt-resources/src/main/java/com/microsoft/azure/management/resources/implementation/PolicyDefinitionsInner.java b/azure-mgmt-resources/src/main/java/com/microsoft/azure/management/resources/implementation/PolicyDefinitionsInner.java
index e852c3628d2..33805c12c5d 100644
--- a/azure-mgmt-resources/src/main/java/com/microsoft/azure/management/resources/implementation/PolicyDefinitionsInner.java
+++ b/azure-mgmt-resources/src/main/java/com/microsoft/azure/management/resources/implementation/PolicyDefinitionsInner.java
@@ -943,7 +943,8 @@ private ServiceResponse<PageImpl<PolicyDefinitionInner>> listBuiltInDelegate(Res
     }
 
     /**
-     * Gets all the policy definitions in a management group.
+     * Retrieve policy definitions in a management group.
+     * This operation retrieves a list of all the policy definitions in a given management group.
      *
      * @param managementGroupId The ID of the management group.
      * @throws IllegalArgumentException thrown if parameters fail the validation
@@ -962,7 +963,8 @@ public Page<PolicyDefinitionInner> nextPage(String nextPageLink) {
     }
 
     /**
-     * Gets all the policy definitions in a management group.
+     * Retrieve policy definitions in a management group.
+     * This operation retrieves a list of all the policy definitions in a given management group.
      *
      * @param managementGroupId The ID of the management group.
      * @param serviceCallback the async ServiceCallback to handle successful and failed responses.
@@ -982,7 +984,8 @@ public Observable<ServiceResponse<Page<PolicyDefinitionInner>>> call(String next
     }
 
     /**
-     * Gets all the policy definitions in a management group.
+     * Retrieve policy definitions in a management group.
+     * This operation retrieves a list of all the policy definitions in a given management group.
      *
      * @param managementGroupId The ID of the management group.
      * @throws IllegalArgumentException thrown if parameters fail the validation
@@ -999,7 +1002,8 @@ public Page<PolicyDefinitionInner> call(ServiceResponse<Page<PolicyDefinitionInn
     }
 
     /**
-     * Gets all the policy definitions in a management group.
+     * Retrieve policy definitions in a management group.
+     * This operation retrieves a list of all the policy definitions in a given management group.
      *
      * @param managementGroupId The ID of the management group.
      * @throws IllegalArgumentException thrown if parameters fail the validation
@@ -1020,7 +1024,8 @@ public Observable<ServiceResponse<Page<PolicyDefinitionInner>>> call(ServiceResp
     }
 
     /**
-     * Gets all the policy definitions in a management group.
+     * Retrieve policy definitions in a management group.
+     * This operation retrieves a list of all the policy definitions in a given management group.
      *
     ServiceResponse<PageImpl<PolicyDefinitionInner>> * @param managementGroupId The ID of the management group.
      * @throws IllegalArgumentException thrown if parameters fail the validation
@@ -1287,7 +1292,8 @@ private ServiceResponse<PageImpl<PolicyDefinitionInner>> listBuiltInNextDelegate
     }
 
     /**
-     * Gets all the policy definitions in a management group.
+     * Retrieve policy definitions in a management group.
+     * This operation retrieves a list of all the policy definitions in a given management group.
      *
      * @param nextPageLink The NextLink from the previous successful call to List operation.
      * @throws IllegalArgumentException thrown if parameters fail the validation
@@ -1306,7 +1312,8 @@ public Page<PolicyDefinitionInner> nextPage(String nextPageLink) {
     }
 
     /**
-     * Gets all the policy definitions in a management group.
+     * Retrieve policy definitions in a management group.
+     * This operation retrieves a list of all the policy definitions in a given management group.
      *
      * @param nextPageLink The NextLink from the previous successful call to List operation.
      * @param serviceFuture the ServiceFuture object tracking the Retrofit calls
@@ -1327,7 +1334,8 @@ public Observable<ServiceResponse<Page<PolicyDefinitionInner>>> call(String next
     }
 
     /**
-     * Gets all the policy definitions in a management group.
+     * Retrieve policy definitions in a management group.
+     * This operation retrieves a list of all the policy definitions in a given management group.
      *
      * @param nextPageLink The NextLink from the previous successful call to List operation.
      * @throws IllegalArgumentException thrown if parameters fail the validation
@@ -1344,7 +1352,8 @@ public Page<PolicyDefinitionInner> call(ServiceResponse<Page<PolicyDefinitionInn
     }
 
     /**
-     * Gets all the policy definitions in a management group.
+     * Retrieve policy definitions in a management group.
+     * This operation retrieves a list of all the policy definitions in a given management group.
      *
      * @param nextPageLink The NextLink from the previous successful call to List operation.
      * @throws IllegalArgumentException thrown if parameters fail the validation
@@ -1365,7 +1374,8 @@ public Observable<ServiceResponse<Page<PolicyDefinitionInner>>> call(ServiceResp
     }
 
     /**
-     * Gets all the policy definitions in a management group.
+     * Retrieve policy definitions in a management group.
+     * This operation retrieves a list of all the policy definitions in a given management group.
      *
     ServiceResponse<PageImpl<PolicyDefinitionInner>> * @param nextPageLink The NextLink from the previous successful call to List operation.
      * @throws IllegalArgumentException thrown if parameters fail the validation