Update documentation for secret placeholders (#4221)

* Update documentation for secret placeholders

fix typo

* docgen

Author: staabm

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')]);
 ```

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')]);
  * ```