diff --git a/docs/api.md b/docs/api.md
index 7e3df6ecf..f8816877a 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -358,7 +358,7 @@ $path = run('readlink {{deploy_path}}/current');
 run("echo $path");
 ```
 
-Pass secrets via `%name%` placeholders so they are redacted in logs:
+Pass secrets via placeholders (e.g. `%token%`) so they are redacted in logs:
 ```php
 run('curl -u admin:%token% https://api.example', secrets: ['token' => getenv('TOKEN')]);
 ```
diff --git a/src/functions.php b/src/functions.php
index a47cb3a17..d7be42887 100644
--- a/src/functions.php
+++ b/src/functions.php
@@ -475,7 +475,7 @@ function within(string $path, callable $callback): mixed
  * run("echo $path");
  * ```
  *
- * Pass secrets via `%name%` placeholders so they are redacted in logs:
+ * Pass secrets via placeholders (e.g. `%token%`) so they are redacted in logs:
  * ```php
  * run('curl -u admin:%token% https://api.example', secrets: ['token' => getenv('TOKEN')]);
  * ```