diff --git a/website/source/docs/provisioners/file.html.md b/website/source/docs/provisioners/file.html.md
index 0dc2e1d01..d2baa868b 100644
--- a/website/source/docs/provisioners/file.html.md
+++ b/website/source/docs/provisioners/file.html.md
@@ -48,8 +48,13 @@ The available configuration options are listed below. All elements are required.
     "upload". If it is set to "download" then the file "source" in the machine
     will be downloaded locally to "destination"
 
--   `generated` (boolean) - If true, check the file existence only before uploading.
-    This allows to upload files created on-the-fly. This defaults to false.
+-   `generated` (boolean) - For advanced users only. If true, check the file
+    existence only before uploading, rather than upon pre-build validation.
+    This allows to upload files created on-the-fly. This defaults to false. We
+    don't recommend using this feature, since it can cause Packer to become
+    dependent on system state. We would prefer you generate your files before
+    the Packer run, but realize that there are situations where this may be
+    unavoidable.
 
 ## Directory Uploads