diff --git a/dev_guide/new_app.adoc b/dev_guide/new_app.adoc
index f820182d8edc..cdcc986d87a7 100644
--- a/dev_guide/new_app.adoc
+++ b/dev_guide/new_app.adoc
@@ -316,7 +316,7 @@ xref:specifying-a-template[templates].
 
 ==== Specifying Environment Variables
 
-When generating applications from a xref:specifying-source-code[source] or an
+When generating applications from a xref:specifying-a-template[template], xref:specifying-source-code[source], or an
 xref:specifying-an-image[image], you can use the `-e|--env` argument to pass
 environment variables to the application container at run time:
 
@@ -329,6 +329,13 @@ $ oc new-app openshift/postgresql-92-centos7 \
 ----
 ====
 
+[NOTE]
+====
+Any `*BuildConfig*` objects created as part of `new-app` processing will not be updated with
+environment variables passed via the `-e|--env` argument.
+====
+
+
 [[specifying-labels]]
 
 ==== Specifying Labels