diff --git a/doc/api/cli.md b/doc/api/cli.md
index 445e903ad9cf72..038929e55aa69c 100644
--- a/doc/api/cli.md
+++ b/doc/api/cli.md
@@ -1119,17 +1119,17 @@ developers may leverage to detect deprecated API usage.
 ### `--permission-fs-path-delimiter`
 
 <!-- YAML
-added: v20.0.0
+added: REPLACEME
 -->
 
 > Stability: 1 - Experimental
 
-This flag configures file system path delimiter for permissions using
+This flag configures the file system path delimiter for permissions using
 the [Permission Model][].
 
 Examples can be found in the [File System Permissions][] documentation.
 
-Especial characters in bash as `;` must be escaped or quoted:
+Special shell characters such as `;` must be escaped or quoted:
 
 ```bash
 node --experimental-permission --permission-fs-path-delimiter=\; \
diff --git a/doc/api/permissions.md b/doc/api/permissions.md
index 79fbe6be6150e1..e21fba978a9a25 100644
--- a/doc/api/permissions.md
+++ b/doc/api/permissions.md
@@ -551,7 +551,8 @@ $ node --experimental-permission --allow-fs-read="/with,commas_/home" \
 --permission-fs-path-delimiter=_ index.js
 ```
 
-Note when using bash special characters like `;` escape or quoting is required.
+Note when using special shell characters such as `;` escaping or quoting is
+required.
 
 ```console
 $ node --experimental-permission --allow-fs-read="/home/with,commas;/home" \