Documentation updates for AWS CloudFormation

Author: aws-sdk-dotnet-automation

generator/ServiceModels/cloudformation/cloudformation-2010-05-15.docs.json

@@ -377,11 +377,13 @@ internal bool IsSetResourceTypes()
         /// <summary>
         /// Gets and sets the property RetainExceptOnCreate. 
         /// <para>
-        /// This deletion policy deletes newly created resources, but retains existing resources,
-        /// when a stack operation is rolled back. This ensures new, empty, and unused resources
-        /// are deleted, while critical resources and their data are retained. <code>RetainExceptOnCreate</code>
-        /// can be specified for any resource that supports the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html">
-        /// DeletionPolicy</a> attribute.
+        /// When set to <code>true</code>, newly created resources are deleted when the operation
+        /// rolls back. This includes newly created resources marked with a deletion policy of
+        /// <code>Retain</code>.
+        /// </para>
+        ///  
+        /// <para>
+        /// Default: <code>false</code> 
         /// </para>
         /// </summary>
         public bool RetainExceptOnCreate

generator/ServiceModels/cloudformation/cloudformation-2010-05-15.normal.json

@@ -59,7 +59,7 @@ public partial class CreateStackSetRequest : AmazonCloudFormationRequest
         /// <para>
         /// Specify an IAM role only if you are using customized administrator roles to control
         /// which users or groups can manage specific stack sets within the same administrator
-        /// account. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/stacksets-prereqs.html">Prerequisites:
+        /// account. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs.html">Prerequisites:
         /// Granting Permissions for Stack Set Operations</a> in the <i>CloudFormation User Guide</i>.
         /// </para>
         /// </summary>
@@ -220,7 +220,7 @@ internal bool IsSetCallAs()
         /// </para>
         ///  </li> </ul> 
         /// <para>
-        /// For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/using-iam-template.html#capabilities">Acknowledging
+        /// For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities">Acknowledging
         /// IAM Resources in CloudFormation Templates</a>.
         /// </para>
         ///  </li> <li> 
@@ -232,14 +232,14 @@ internal bool IsSetCallAs()
         /// Some templates reference macros. If your stack set template references one or more
         /// macros, you must create the stack set directly from the processed template, without
         /// first reviewing the resulting changes in a change set. To create the stack set directly,
-        /// you must acknowledge this capability. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/template-macros.html">Using
+        /// you must acknowledge this capability. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html">Using
         /// CloudFormation Macros to Perform Custom Processing on Templates</a>.
         /// </para>
         ///  <important> 
         /// <para>
         /// Stack sets with service-managed permissions don't currently support the use of macros
-        /// in templates. (This includes the <a href="https://docs.aws.amazon.com/AWSCloudFormation/create-reusable-transform-function-snippets-and-add-to-your-template-with-aws-include-transform.html">AWS::Include</a>
-        /// and <a href="https://docs.aws.amazon.com/AWSCloudFormation/transform-aws-serverless.html">AWS::Serverless</a>
+        /// in templates. (This includes the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/create-reusable-transform-function-snippets-and-add-to-your-template-with-aws-include-transform.html">AWS::Include</a>
+        /// and <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html">AWS::Serverless</a>
         /// transforms, which are macros hosted by CloudFormation.) Even if you specify this capability
         /// for a stack set with service-managed permissions, if you reference a macro in your
         /// template the stack set operation will fail.

sdk/src/Services/CloudFormation/Generated/Model/CreateStackRequest.cs

@@ -67,8 +67,12 @@ internal bool IsSetNextToken()
         /// Gets and sets the property StackName. <note> 
         /// <para>
         /// If you don't pass a parameter to <code>StackName</code>, the API returns a response
-        /// that describes all resources in the account. This requires <code>ListStacks</code>
-        /// and <code>DescribeStacks</code> permissions.
+        /// that describes all resources in the account, which can impact performance. This requires
+        /// <code>ListStacks</code> and <code>DescribeStacks</code> permissions.
+        /// </para>
+        ///  
+        /// <para>
+        /// Consider using the <a>ListStacks</a> API if you're not passing a parameter to <code>StackName</code>.
         /// </para>
         ///  
         /// <para>

sdk/src/Services/CloudFormation/Generated/Model/CreateStackSetRequest.cs

@@ -143,11 +143,13 @@ internal bool IsSetDisableRollback()
         /// <summary>
         /// Gets and sets the property RetainExceptOnCreate. 
         /// <para>
-        /// This deletion policy deletes newly created resources, but retains existing resources,
-        /// when a stack operation is rolled back. This ensures new, empty, and unused resources
-        /// are deleted, while critical resources and their data are retained. <code>RetainExceptOnCreate</code>
-        /// can be specified for any resource that supports the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html">
-        /// DeletionPolicy</a> attribute.
+        /// When set to <code>true</code>, newly created resources are deleted when the operation
+        /// rolls back. This includes newly created resources marked with a deletion policy of
+        /// <code>Retain</code>.
+        /// </para>
+        ///  
+        /// <para>
+        /// Default: <code>false</code> 
         /// </para>
         /// </summary>
         public bool RetainExceptOnCreate

sdk/src/Services/CloudFormation/Generated/Model/DescribeStacksRequest.cs

@@ -96,11 +96,13 @@ internal bool IsSetClientRequestToken()
         /// <summary>
         /// Gets and sets the property RetainExceptOnCreate. 
         /// <para>
-        /// This deletion policy deletes newly created resources, but retains existing resources,
-        /// when a stack operation is rolled back. This ensures new, empty, and unused resources
-        /// are deleted, while critical resources and their data are retained. <code>RetainExceptOnCreate</code>
-        /// can be specified for any resource that supports the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html">
-        /// DeletionPolicy</a> attribute.
+        /// When set to <code>true</code>, newly created resources are deleted when the operation
+        /// rolls back. This includes newly created resources marked with a deletion policy of
+        /// <code>Retain</code>.
+        /// </para>
+        ///  
+        /// <para>
+        /// Default: <code>false</code> 
         /// </para>
         /// </summary>
         public bool RetainExceptOnCreate

sdk/src/Services/CloudFormation/Generated/Model/ExecuteChangeSetRequest.cs

@@ -325,11 +325,13 @@ internal bool IsSetParentId()
         /// <summary>
         /// Gets and sets the property RetainExceptOnCreate. 
         /// <para>
-        /// This deletion policy deletes newly created resources, but retains existing resources,
-        /// when a stack operation is rolled back. This ensures new, empty, and unused resources
-        /// are deleted, while critical resources and their data are retained. <code>RetainExceptOnCreate</code>
-        /// can be specified for any resource that supports the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html">
-        /// DeletionPolicy</a> attribute.
+        /// When set to <code>true</code>, newly created resources are deleted when the operation
+        /// rolls back. This includes newly created resources marked with a deletion policy of
+        /// <code>Retain</code>.
+        /// </para>
+        ///  
+        /// <para>
+        /// Default: <code>false</code> 
         /// </para>
         /// </summary>
         public bool RetainExceptOnCreate

sdk/src/Services/CloudFormation/Generated/Model/RollbackStackRequest.cs

@@ -63,7 +63,7 @@ public partial class StackSet
         ///  
         /// <para>
         /// Use customized administrator roles to control which users or groups can manage specific
-        /// stack sets within the same administrator account. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/stacksets-prereqs.html">Prerequisites:
+        /// stack sets within the same administrator account. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs.html">Prerequisites:
         /// Granting Permissions for Stack Set Operations</a> in the <i>CloudFormation User Guide</i>.
         /// </para>
         /// </summary>

sdk/src/Services/CloudFormation/Generated/Model/Stack.cs

@@ -77,7 +77,7 @@ internal bool IsSetAction()
         ///  
         /// <para>
         /// Use customized administrator roles to control which users or groups can manage specific
-        /// stack sets within the same administrator account. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/stacksets-prereqs.html">Define
+        /// stack sets within the same administrator account. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs.html">Define
         /// Permissions for Multiple Administrators</a> in the <i>CloudFormation User Guide</i>.
         /// </para>
         /// </summary>