From 5ffb1067838754def9a943089a1785f44d8f883c Mon Sep 17 00:00:00 2001
From: Radek Simko <radek.simko@gmail.com>
Date: Wed, 6 Feb 2019 12:53:18 +0100
Subject: [PATCH] docs/upgrade-guide: Document changes in remote state
 referencing

---
 website/upgrade-guides/0-12.html.markdown | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/website/upgrade-guides/0-12.html.markdown b/website/upgrade-guides/0-12.html.markdown
index 57b6557df..c45d15e7b 100644
--- a/website/upgrade-guides/0-12.html.markdown
+++ b/website/upgrade-guides/0-12.html.markdown
@@ -53,6 +53,23 @@ be no required changes. However, we still recommend to run the migration tool
 to upgrade to the more readable syntax conventions supported in this release,
 and to draw attention to any potential issues.
 
+## Remote State Referencing
+
+`terraform` provider has changed schema which caused all outputs to be nested
+under `outputs` field.
+
+### Before
+
+```hcl
+data.terraform_remote_state.vpc.something
+```
+
+### After
+
+```hcl
+data.terraform_remote_state.vpc.outputs.something
+```
+
 ## Upgrading Terraform providers
 
 We’ve updated the RPC protocol used by Terraform plugins to support typed data