Improved the visibility of the guidance for updating AWS WAF resources, such as web ACLs and rule groups.

Author: aws-sdk-dotnet-automation

generator/ServiceModels/wafv2/wafv2-2019-07-29.docs.json

@@ -77,8 +77,8 @@ internal bool IsSetMaxItems()
         /// <summary>
         /// Gets and sets the property RuleMetricName. 
         /// <para>
-        /// The metric name assigned to the <code>Rule</code> or <code>RuleGroup</code> for which
-        /// you want a sample of requests.
+        /// The metric name assigned to the <code>Rule</code> or <code>RuleGroup</code> dimension
+        /// for which you want a sample of requests.
         /// </para>
         /// </summary>
         [AWSProperty(Required=true, Min=1, Max=255)]

generator/ServiceModels/wafv2/wafv2-2019-07-29.endpoint-tests.json

@@ -35,6 +35,27 @@ namespace Amazon.WAFV2.Model
     /// 
     ///  <note> 
     /// <para>
+    /// This operation completely replaces any mutable specifications that you already have
+    /// for a logging configuration with the ones that you provide to this call. 
+    /// </para>
+    ///  
+    /// <para>
+    /// To modify an existing logging configuration, do the following: 
+    /// </para>
+    ///  <ol> <li> 
+    /// <para>
+    /// Retrieve it by calling <a>GetLoggingConfiguration</a> 
+    /// </para>
+    ///  </li> <li> 
+    /// <para>
+    /// Update its settings as needed
+    /// </para>
+    ///  </li> <li> 
+    /// <para>
+    /// Provide the complete logging configuration specification to this call
+    /// </para>
+    ///  </li> </ol> </note> <note> 
+    /// <para>
     /// You can define one logging destination per web ACL.
     /// </para>
     ///  </note> 
@@ -78,15 +99,6 @@ namespace Amazon.WAFV2.Model
     /// For additional information about web ACL logging, see <a href="https://docs.aws.amazon.com/waf/latest/developerguide/logging.html">Logging
     /// web ACL traffic information</a> in the <i>WAF Developer Guide</i>.
     /// </para>
-    ///  <note> 
-    /// <para>
-    /// This operation completely replaces the mutable specifications that you already have
-    /// for the logging configuration with the ones that you provide to this call. To modify
-    /// the logging configuration, retrieve it by calling <a>GetLoggingConfiguration</a>,
-    /// update the settings as needed, and then provide the complete logging configuration
-    /// specification to this call.
-    /// </para>
-    ///  </note>
     /// </summary>
     public partial class PutLoggingConfigurationRequest : AmazonWAFV2Request
     {

generator/ServiceModels/wafv2/wafv2-2019-07-29.normal.json

@@ -35,11 +35,25 @@ namespace Amazon.WAFV2.Model
     ///  <note> 
     /// <para>
     /// This operation completely replaces the mutable specifications that you already have
-    /// for the IP set with the ones that you provide to this call. To modify the IP set,
-    /// retrieve it by calling <a>GetIPSet</a>, update the settings as needed, and then provide
-    /// the complete IP set specification to this call.
+    /// for the IP set with the ones that you provide to this call. 
     /// </para>
-    ///  </note> 
+    ///  
+    /// <para>
+    /// To modify an IP set, do the following: 
+    /// </para>
+    ///  <ol> <li> 
+    /// <para>
+    /// Retrieve it by calling <a>GetIPSet</a> 
+    /// </para>
+    ///  </li> <li> 
+    /// <para>
+    /// Update its settings as needed
+    /// </para>
+    ///  </li> <li> 
+    /// <para>
+    /// Provide the complete IP set specification to this call
+    /// </para>
+    ///  </li> </ol> </note> 
     /// <para>
     /// When you make changes to web ACLs or web ACL components, like rules and rule groups,
     /// WAF propagates the changes everywhere that the web ACL and its components are stored

sdk/src/Services/WAFV2/Generated/Model/GetSampledRequestsRequest.cs

@@ -35,11 +35,25 @@ namespace Amazon.WAFV2.Model
     ///  <note> 
     /// <para>
     /// This operation completely replaces the mutable specifications that you already have
-    /// for the regex pattern set with the ones that you provide to this call. To modify the
-    /// regex pattern set, retrieve it by calling <a>GetRegexPatternSet</a>, update the settings
-    /// as needed, and then provide the complete regex pattern set specification to this call.
+    /// for the regex pattern set with the ones that you provide to this call. 
     /// </para>
-    ///  </note> 
+    ///  
+    /// <para>
+    /// To modify a regex pattern set, do the following: 
+    /// </para>
+    ///  <ol> <li> 
+    /// <para>
+    /// Retrieve it by calling <a>GetRegexPatternSet</a> 
+    /// </para>
+    ///  </li> <li> 
+    /// <para>
+    /// Update its settings as needed
+    /// </para>
+    ///  </li> <li> 
+    /// <para>
+    /// Provide the complete regex pattern set specification to this call
+    /// </para>
+    ///  </li> </ol> </note> 
     /// <para>
     /// When you make changes to web ACLs or web ACL components, like rules and rule groups,
     /// WAF propagates the changes everywhere that the web ACL and its components are stored

sdk/src/Services/WAFV2/Generated/Model/PutLoggingConfigurationRequest.cs

@@ -35,11 +35,25 @@ namespace Amazon.WAFV2.Model
     ///  <note> 
     /// <para>
     /// This operation completely replaces the mutable specifications that you already have
-    /// for the rule group with the ones that you provide to this call. To modify the rule
-    /// group, retrieve it by calling <a>GetRuleGroup</a>, update the settings as needed,
-    /// and then provide the complete rule group specification to this call.
+    /// for the rule group with the ones that you provide to this call. 
     /// </para>
-    ///  </note> 
+    ///  
+    /// <para>
+    /// To modify a rule group, do the following: 
+    /// </para>
+    ///  <ol> <li> 
+    /// <para>
+    /// Retrieve it by calling <a>GetRuleGroup</a> 
+    /// </para>
+    ///  </li> <li> 
+    /// <para>
+    /// Update its settings as needed
+    /// </para>
+    ///  </li> <li> 
+    /// <para>
+    /// Provide the complete rule group specification to this call
+    /// </para>
+    ///  </li> </ol> </note> 
     /// <para>
     /// When you make changes to web ACLs or web ACL components, like rules and rule groups,
     /// WAF propagates the changes everywhere that the web ACL and its components are stored

sdk/src/Services/WAFV2/Generated/Model/UpdateIPSetRequest.cs

@@ -33,8 +33,29 @@ namespace Amazon.WAFV2.Model
     /// Updates the specified <a>WebACL</a>. While updating a web ACL, WAF provides continuous
     /// coverage to the resources that you have associated with the web ACL. 
     /// 
+    ///  <note> 
+    /// <para>
+    /// This operation completely replaces the mutable specifications that you already have
+    /// for the web ACL with the ones that you provide to this call. 
+    /// </para>
     ///  
     /// <para>
+    /// To modify a web ACL, do the following: 
+    /// </para>
+    ///  <ol> <li> 
+    /// <para>
+    /// Retrieve it by calling <a>GetWebACL</a> 
+    /// </para>
+    ///  </li> <li> 
+    /// <para>
+    /// Update its settings as needed
+    /// </para>
+    ///  </li> <li> 
+    /// <para>
+    /// Provide the complete web ACL specification to this call
+    /// </para>
+    ///  </li> </ol> </note> 
+    /// <para>
     /// When you make changes to web ACLs or web ACL components, like rules and rule groups,
     /// WAF propagates the changes everywhere that the web ACL and its components are stored
     /// and used. Your changes are applied within seconds, but there might be a brief period
@@ -47,14 +68,7 @@ namespace Amazon.WAFV2.Model
     /// ACL that is already associated with a resource. Generally, any inconsistencies of
     /// this type last only a few seconds.
     /// </para>
-    ///  <note> 
-    /// <para>
-    /// This operation completely replaces the mutable specifications that you already have
-    /// for the web ACL with the ones that you provide to this call. To modify the web ACL,
-    /// retrieve it by calling <a>GetWebACL</a>, update the settings as needed, and then provide
-    /// the complete web ACL specification to this call.
-    /// </para>
-    ///  </note> 
+    ///  
     /// <para>
     ///  A web ACL defines a collection of rules to use to inspect and control web requests.
     /// Each rule has an action defined (allow, block, or count) for requests that match the

sdk/src/Services/WAFV2/Generated/Model/UpdateRegexPatternSetRequest.cs

@@ -61,10 +61,10 @@ internal bool IsSetCloudWatchMetricsEnabled()
         /// <summary>
         /// Gets and sets the property MetricName. 
         /// <para>
-        /// A name of the Amazon CloudWatch metric. The name can contain only the characters:
+        /// A name of the Amazon CloudWatch metric dimension. The name can contain only the characters:
         /// A-Z, a-z, 0-9, - (hyphen), and _ (underscore). The name can be from one to 128 characters
-        /// long. It can't contain whitespace or metric names reserved for WAF, for example <code>All</code>
-        /// and <code>Default_Action</code>. 
+        /// long. It can't contain whitespace or metric names that are reserved for WAF, for example
+        /// <code>All</code> and <code>Default_Action</code>. 
         /// </para>
         /// </summary>
         [AWSProperty(Required=true, Min=1, Max=255)]