From 6613a18df28ab2e6f8c317bc9a92cb495d83f4c5 Mon Sep 17 00:00:00 2001
From: Michael McCracken <mikmccra@cisco.com>
Date: Mon, 15 Apr 2024 15:57:43 -0700
Subject: [PATCH] fix: fix another incorrect substitution doc

this was missed earlier

Signed-off-by: Michael McCracken <mikmccra@cisco.com>
---
 doc/stacker_yaml.md | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/doc/stacker_yaml.md b/doc/stacker_yaml.md
index 546e4eae..50eba38c 100644
--- a/doc/stacker_yaml.md
+++ b/doc/stacker_yaml.md
@@ -1,15 +1,17 @@
 ## The `stacker.yaml` file
 
 When doing a `stacker build`, the behavior of stacker is specified by the yaml
-directives below. In addition to these, stacker allows variable substitions of
-several forms. For example, a line like:
+directives below. 
 
-    $ONE ${{TWO}} ${{THREE:3}}
+Before the yaml is parsed, stacker performs substitution on placeholders in the
+file of the format `${{VAR}}` or `${{VAR:default}}`. For example, a line like:
 
-When run with `stacker build --substitute ONE=1 --substitute TWO=2` is
+    ${{ONE}} ${{TWO:3}}
+
+When run with `stacker build --substitute ONE=1` is
 processed in stacker as:
 
-    1 2 3
+    1 3
 
 In order to avoid conflict with bash or POSIX shells in the `run` section, 
 only placeholders with two braces are supported, e.g. `${{FOO}}`.