diff --git a/website/docs/commands/push.html.markdown b/website/docs/commands/push.html.markdown
index 388f10a68..ee667bce5 100644
--- a/website/docs/commands/push.html.markdown
+++ b/website/docs/commands/push.html.markdown
@@ -25,6 +25,11 @@ future update of Terraform Enterprise will allow parallel Terraform runs and aut
perform infrastructure locking so only one run is modifying the same
infrastructure at a time.
+~> When using this command, it is important to match your local Terraform version with
+ the version selected for the target workspace in Terraform Enterprise, since
+ otherwise the uploaded configuration archive may not be compatible with the remote
+ Terraform process.
+
## Usage
Usage: `terraform push [options] [path]`
@@ -90,6 +95,13 @@ all the files to be safe. To exclude certain files, specify the `-exclude`
flag when pushing, or specify the `exclude` parameter in the
[Terraform Enterprise configuration section](/docs/configuration/terraform-enterprise.html).
+Terraform also includes in the package all of the modules that were installed
+during the most recent `terraform init` or `terraform get` command. Since the
+details of how modules are cached in the filesystem vary between Terraform versions,
+it is important to use the same version of Terraform both locally (when running
+`terraform init` and then `terraform push`) and in your remote Terraform Enterprise
+workspace.
+
## Terraform Variables
When you `push`, Terraform will automatically set the local values of