From d7c3221b02db55904bd28765c7a95700a322e734 Mon Sep 17 00:00:00 2001
From: Clint Shryock <clint@ctshryock.com>
Date: Wed, 12 Aug 2015 11:00:05 -0500
Subject: [PATCH] providers/aws: Update Launch Config. docs to detail naming
 and lifecycle recommendation

---
 website/Gemfile.lock                          |  3 --
 .../aws/r/launch_configuration.html.markdown  | 38 ++++++++++++++++++-
 2 files changed, 36 insertions(+), 5 deletions(-)

diff --git a/website/Gemfile.lock b/website/Gemfile.lock
index 8e4867a68..826d25e8f 100644
--- a/website/Gemfile.lock
+++ b/website/Gemfile.lock
@@ -180,6 +180,3 @@ PLATFORMS
 
 DEPENDENCIES
   middleman-hashicorp!
-
-BUNDLED WITH
-   1.10.5
diff --git a/website/source/docs/providers/aws/r/launch_configuration.html.markdown b/website/source/docs/providers/aws/r/launch_configuration.html.markdown
index 8b8507d52..ea96503dc 100644
--- a/website/source/docs/providers/aws/r/launch_configuration.html.markdown
+++ b/website/source/docs/providers/aws/r/launch_configuration.html.markdown
@@ -10,8 +10,6 @@ description: |-
 
 Provides a resource to create a new launch configuration, used for autoscaling groups.
 
-~> **NOTE:** You may want to omit `name` attribute from attached `aws_launch_configuration`. When you [create](http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/LaunchConfiguration.html) a launch configuration, you cannot edit it. Terraform will treat a change in this resource as a destroy and create action. If you add a name to your launch configuration, then terraform will not be able to create the replacement launch configuration due to the name being the same.
-
 ## Example Usage
 
 ```
@@ -22,6 +20,39 @@ resource "aws_launch_configuration" "as_conf" {
 }
 ```
 
+## Using with AutoScaling Groups
+
+Launch Configurations cannot be updated after creation with the Amazon
+Web Service API. In order to update a Launch Configuration, Terraform will 
+destroy the existing resource and create a replacement. If order to effectively 
+use a Launch Configuration resource with an[AutoScaling Group resource][1], 
+it's recommend to omit the Launch Configuration `name` attribute, and 
+specify `create_before_destroy` in a [lifecycle][2] block, as shown:
+
+```
+resource "aws_launch_configuration" "as_conf" {
+    image_id = "ami-1234"
+    instance_type = "m1.small"
+
+    lifecycle {
+      create_before_destroy = true
+    }
+}
+
+resource "aws_autoscaling_group" "bar" {
+    name = "terraform-asg-example"
+    launch_configuration = "${aws_launch_configuration.as_conf.name}"
+
+    lifecycle {
+      create_before_destroy = true
+    }
+}
+```
+
+With this setup Terraform generates a unique name for your Launch
+Configuration and can then update the AutoScaling Group without conflict before
+destroying the previous Launch Configuration.
+
 ## Argument Reference
 
 The following arguments are supported:
@@ -100,3 +131,6 @@ configuration, resource recreation can be manually triggered by using the
 The following attributes are exported:
 
 * `id` - The ID of the launch configuration.
+
+[1]: /docs/providers/aws/r/autoscaling_group.html
+[2]: /docs/configuration/resources.html#lifecycle