diff --git a/examples/README.md b/examples/README.md
index adcdf367f..eb259837b 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -35,7 +35,7 @@ go get sigs.k8s.io/kustomize
  * [breakfast](breakfast.md) - Customize breakfast for
    Alice and Bob.
    
- * [container args](wordpress/README.md) - Injecting k8s runtime data into container arguments (e.g. to point wordpress to a SQL service).
+ * [vars](wordpress/README.md) - Injecting k8s runtime data into container arguments (e.g. to point wordpress to a SQL service) by vars.
  
  * [image tags](imageTags.md) - Updating image tags without applying a patch.
 
diff --git a/examples/wordpress/README.md b/examples/wordpress/README.md
index 7746f0257..2b7a86749 100644
--- a/examples/wordpress/README.md
+++ b/examples/wordpress/README.md
@@ -1,6 +1,6 @@
 # Demo: Injecting k8s runtime data into containers
 
-In this tutorial, you will learn how to use `kustomize` to declare a variable reference and substitute it in container's command.
+In this tutorial, you will learn how to use `kustomize` to declare a variable reference and substitute it in container's command. Note that, the substitution is not for arbitrary fields, it is only applicable to container env, args and command. 
 
 To run WordPress, it's necessary to