README.md in cloudformation-ruby-dsl-0.4.5 vs README.md in cloudformation-ruby-dsl-0.4.6
- old
+ new
@@ -1,20 +1,20 @@
# cloudformation-ruby-dsl
-A Ruby DSL and helper utilities for building Cloudformation templates dynamically.
+A Ruby DSL and helper utilities for building CloudFormation templates dynamically.
Written by [Bazaarvoice](http://www.bazaarvoice.com): see [the contributors page](https://github.com/bazaarvoice/cloudformation-ruby-dsl/graphs/contributors) and [the initial contributions](https://github.com/bazaarvoice/cloudformation-ruby-dsl/blob/master/initial_contributions.md) for more details.
## Motivation
-Cloudformation templates often contain repeated stanzas, information which must be loaded from external sources, and other functionality that would be easier handled as code, instead of configuration.
+CloudFormation templates often contain repeated stanzas, information which must be loaded from external sources, and other functionality that would be easier handled as code, instead of configuration.
-Consider when a userdata script needs to be added to a Cloudformation template. Traditionally, you would re-write the script by hand in a valid JSON format. Using the DSL, you can specify the file containing the script and generate the correct information at runtime.
+Consider when a userdata script needs to be added to a CloudFormation template. Traditionally, you would re-write the script by hand in a valid JSON format. Using the DSL, you can specify the file containing the script and generate the correct information at runtime.
:UserData => base64(interpolate(file('userdata.sh')))
-Additionally, Cloudformation templates are just massive JSON documents, making general readability and reusability an issue. The DSL allows not only a cleaner format (and comments!), but will also allow the same DSL template to be reused as needed.
+Additionally, CloudFormation templates are just massive JSON documents, making general readability and reusability an issue. The DSL allows not only a cleaner format (and comments!), but will also allow the same DSL template to be reused as needed.
## Installation
Run `gem install cloudformation-ruby-dsl` to install system-wide.
@@ -44,20 +44,27 @@
- `mapping(name, options)`
- `condition(name, options)`
- `resource(name, options)`
- `output(name, options)`
-### Cloudformation Function Calls
+### CloudFormation Function Calls
-Invoke a native Cloudformation function.
+Invoke an intrinsic CloudFormation function.
- `base64(value)`
- `find_in_map(map, key, name)`
- `get_att(resource, attribute)`
- `get_azs(region)`
- `join(delim, *list)`
- `select(index, list)`
- `ref(name)`
-- `no_value()`
+
+Reference a CloudFormation pseudo parameter.
+- `aws_account_id()`
+- `aws_notification_arns()`
+- `aws_no_value()`
+- `aws_region()`
+- `aws_stack_id()`
+- `aws_stack_name()`
### Utility Functions
Additional capabilities for file inclusion, etc.
- `tag(tag)`: add tags to the stack, which are inherited by all resources in that stack; can only be used at launch