diff --git a/website/docs/backends/types/s3.html.md b/website/docs/backends/types/s3.html.md
index e82087971..437d9f2de 100644
--- a/website/docs/backends/types/s3.html.md
+++ b/website/docs/backends/types/s3.html.md
@@ -112,8 +112,10 @@ data "terraform_remote_state" "network" {
 }
 ```
 
-The `terraform_remote_state` data source will return all of the root outputs
-defined in the referenced remote state, an example output might look like:
+The `terraform_remote_state` data source will return all of the root module 
+outputs defined in the referenced remote state (but not any outputs from 
+nested modules unless they are explicitly output again in the root). An 
+example output might look like:
 
 ```
 data.terraform_remote_state.network: