doc: improve fs permissions description

Fix a small grammatical mistake and improve the surrounding wording.

PR-URL: #47596
Reviewed-By: Rafael Gonzaga <[email protected]>
Reviewed-By: Filip Skokan <[email protected]>

Author: tniessen

doc/api/cli.md

@@ -154,8 +154,9 @@ the [Permission Model][].
 
 The valid arguments for the `--allow-fs-read` flag are:
 
-* `*` - To allow the `FileSystemRead` operations.
-* Paths delimited by comma (,) to manage `FileSystemRead` (reading) operations.
+* `*` - To allow all `FileSystemRead` operations.
+* Paths delimited by comma (`,`) to allow only matching `FileSystemRead`
+  operations.
 
 Examples can be found in the [File System Permissions][] documentation.
 
@@ -200,8 +201,9 @@ the [Permission Model][].
 
 The valid arguments for the `--allow-fs-write` flag are:
 
-* `*` - To allow the `FileSystemWrite` operations.
-* Paths delimited by comma (,) to manage `FileSystemWrite` (writing) operations.
+* `*` - To allow all `FileSystemWrite` operations.
+* Paths delimited by comma (`,`) to allow only matching `FileSystemWrite`
+  operations.
 
 Examples can be found in the [File System Permissions][] documentation.
 

doc/api/permissions.md

@@ -520,8 +520,10 @@ Hello world!
 
 The valid arguments for both flags are:
 
-* `*` - To allow the all operations to given scope (read/write).
-* Paths delimited by comma (,) to manage reading/writing operations.
+* `*` - To allow all `FileSystemRead` or `FileSystemWrite` operations,
+  respectively.
+* Paths delimited by comma (`,`) to allow only matching `FileSystemRead` or
+  `FileSystemWrite` operations, respectively.
 
 Example: