diff --git a/docs/stdio.md b/docs/stdio.md
index 2a9d8ebf0..2d7e0e316 100644
--- a/docs/stdio.md
+++ b/docs/stdio.md
@@ -5,9 +5,11 @@ How stdin, stdout, and stderr are connected to task processes, controlled by the
 ## The `--log` Flag
 
 ```
-vp run build --log=<mode>
+vp run --log=<mode> build
 ```
 
+The flag goes before the task name. Anything after the task name is passed to the task, so `vp run build --log=grouped` runs the task's command with `--log=grouped` appended.
+
 | Mode                        | Description                                                                   |
 | --------------------------- | ----------------------------------------------------------------------------- |
 | `interleaved` **(default)** | Output streams directly to the terminal as tasks produce it.                  |