address review comments

Author: Hunterness

modules/ROOT/pages/authentication-authorization/manage-privileges.adoc

@@ -438,8 +438,9 @@ Other users' privileges cannot be listed when using a non-native auth provider.
 
 When using the `RETURN` clause, the `YIELD` clause is mandatory and must not be omitted.
 
-For an easy overview of the existing privileges, it is recommended to use the `AS COMMANDS` version of the `SHOW` command.
-This returns two columns:
+For an easy overview of the existing privileges, it is recommended to use the `AS COMMANDS` version of the `SHOW` command, which returns two columns.
+
+.`SHOW PRIVILEGES AS COMMANDS` output
 [options="header", width="100%", cols="2a,4,2m"]
 |===
 | Column
@@ -456,9 +457,10 @@ Or in the `AS REVOKE COMMANDS` case, the command to revoke the privilege. label:
 | BOOLEAN
 |===
 
-When omitting the `AS COMMANDS` clause, results will include multiple columns describing privileges instead.
-They are all returned by default.
+Alternatively, you can omit the `AS COMMANDS` clause and get the full details of the privileges returned in multiple columns.
+They are all returned by default without requiring a `YIELD`.
 
+.`SHOW PRIVILEGES` output
 [options="header", width="100%", cols="4m,6a,2m"]
 |===
 | Column | Description | Type

modules/ROOT/pages/authentication-authorization/manage-roles.adoc

@@ -339,9 +339,9 @@ For more information, see xref:authentication-authorization/dbms-administration.
 == Listing roles
 
 
-Available roles can be seen using `SHOW ROLES`.
+You can view all available roles using the Cypher command `SHOW ROLES`, which returns a single column.
 
-This returns a single column.
+.`SHOW ROLES` output
 [options="header", width="100%", cols="2a,4,2m"]
 |===
 | Column
@@ -394,6 +394,8 @@ There are multiple versions of this command, the default being `SHOW ALL ROLES`.
 To only show roles that are assigned to users, the command is `SHOW POPULATED ROLES`.
 To see which users are assigned to which roles, `WITH USERS` can be added to the command.
 The command produces a row per role per user and yields the following column in addition to the one output by `SHOW ROLES`:
+
+.`SHOW POPULATED ROLES WITH USERS` output
 [options="header", width="100%", cols="2a,4,2m"]
 |===
 | Column
@@ -404,7 +406,8 @@ The command produces a row per role per user and yields the following column in
 | User name
 | STRING
 |===
-Since this gives a result with one row for each user, if a role is assigned to two users it will show up twice.
+
+Since this gives a result with one row for each user, it shows up twice if a role is assigned to two users.
 
 .Show roles with users
 ====