From 774cbb82feb5e166cd5eddb0ebfee5a03d8bde0b Mon Sep 17 00:00:00 2001
From: Mitchell Hashimoto <mitchell.hashimoto@gmail.com>
Date: Tue, 29 Nov 2016 10:34:51 -0800
Subject: [PATCH] website: update upgrade guide

---
 .../source/upgrade-guides/0-8.html.markdown   | 34 +++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/website/source/upgrade-guides/0-8.html.markdown b/website/source/upgrade-guides/0-8.html.markdown
index 1292e803d1..c856718d9d 100644
--- a/website/source/upgrade-guides/0-8.html.markdown
+++ b/website/source/upgrade-guides/0-8.html.markdown
@@ -23,6 +23,40 @@ list of changes will always be the
 After reviewing this guide, we recommend reviewing the Changelog to check on
 specific notes about the resources and providers you use.
 
+## Newlines in Strings
+
+Newlines are no longer allowed in strings unless it is a heredoc or an
+interpolation. This improves the performance of IDE syntax highlighting
+of Terraform configurations and simplifies parsing.
+
+**Behavior that no longer works in Terraform 0.8:**
+
+```
+resource "null_resource" "foo" {
+  value = "foo
+bar"
+}
+```
+
+**Valid Terraform 0.8 configuration:**
+
+```
+resource "null_resource" "foo" {
+  value = "foo\nbar"
+
+  value2 = <<EOF
+foo
+bar
+EOF
+
+  # You can still have newlines within interpolations.
+  value3 = "${lookup(
+    var.foo, var.bar)}"
+}
+```
+
+**Action:** Use heredocs or escape sequences when you have a string with newlines.
+
 ## Math Order of Operations
 
 Math operations now follow standard mathematical order of operations.