updating documentation

Author: Garison Draper

docs/config.rst

@@ -219,12 +219,18 @@ the build action::
 Tags
 ----
 
-CloudFormation supports arbitrary key-value pair tags. All stack-level, including automatically created tags, are
-propagated to resources that AWS CloudFormation supports. See `AWS CloudFormation Resource Tags Type`_ for more details.
-If no tags are specified, the `stacker_namespace` tag is applied to your stack with the value of `namespace` as the
-tag value.
+Verious resources in AWS support arbitrary key-value pair tags. You can set
+the `tags` Top Level Keyword to populate tags on all Resources that support
+that feature. The S3 bucket created by stacker for CFN uploads and all
+Cloudformation stack-level resouces, including automatically created tags,
+are propagated to resources that AWS CloudFormation supports. See
+`AWS CloudFormation Resource Tags Type`_ for more details.
 
-If you prefer to apply a custom set of tags, specify the top-level keyword `tags` as a map. Example::
+If no tags are specified, the `stacker_namespace` tag is applied to your stack
+with the value of `namespace` as the tag value.
+
+If you prefer to apply a custom set of tags, specify the top-level keyword
+`tags` as a map. Example::
 
   tags:
     "hello": world
@@ -236,6 +242,8 @@ map for the top-level keyword::
 
   tags: {}
 
+Tags are updated on every stacker run
+
 .. _`AWS CloudFormation Resource Tags Type`: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html
 
 Mappings

stacker/util.py

@@ -474,8 +474,8 @@ def ensure_s3_bucket(s3_client, bucket_name, bucket_region, context):
         bucket_name (str): The bucket being checked/created.
         bucket_region (str, optional): The region to create the bucket in. If
             not provided, will be determined by s3_client's region.
-        context (:class:`stacker.context.Context`): context instance, used to
-            set tags on the S3 bucket created from the stacker config
+        context (:class:`stacker.context.Context`): The stacker context, used
+            set the S3 bucket tags from the stacker config
 
     """
     try: