Update the column descriptions for SHOW ROLES

to be more visible as tables and not just part of the text, this is what most show commands does

also make the examples proper examples

Author: Hunterness

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

@@ -131,7 +131,7 @@ Lists the privileges granted to the specified roles.
 
 When using the `RETURN` clause, the `YIELD` clause is mandatory and must not be omitted.
 
-For more information, see xref:authentication-authorization/manage-privileges.adoc#access-control-list-privileges[Listing privileges].
+The `SHOW ROLE name PRIVILEGES` command is described in xref:authentication-authorization/manage-privileges.adoc#access-control-list-privileges[Listing privileges].
 
 | Required privilege
 a|
@@ -340,8 +340,21 @@ For more information, see xref:authentication-authorization/dbms-administration.
 
 
 Available roles can be seen using `SHOW ROLES`.
-This returns a single column `role` of type `STRING`, containing the role name.
 
+This returns a single column.
+[options="header", width="100%", cols="2a,4,2m"]
+|===
+| Column
+| Description
+| Type
+
+| role
+| Role name
+| STRING
+|===
+
+.List all roles
+====
 [source, cypher, role=noplay]
 ----
 SHOW ROLES
@@ -363,6 +376,7 @@ This is the same command as `SHOW ALL ROLES`.
 
 1+a|Rows: 6
 |===
+====
 
 When first starting a Neo4j DBMS, there are a number of built-in roles:
 
@@ -379,9 +393,21 @@ More information about the built-in roles and their privileges can be found in x
 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.
-This will return an additional `STRING` column, `member`, containing the username.
+The command produces a row per role per user and yields the following column in addition to the one output by `SHOW ROLES`:
+[options="header", width="100%", cols="2a,4,2m"]
+|===
+| Column
+| Description
+| Type
+
+| member
+| 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.
 
+.Show roles with users
+====
 [source, cypher, role=noplay]
 ----
 SHOW POPULATED ROLES WITH USERS
@@ -415,9 +441,12 @@ The table of results will show information about the role and what database it b
 
 2+a|Rows: 6
 |===
+====
 
-It is also possible to filter and sort the results by using `YIELD`, `ORDER BY` and `WHERE`:
+It is also possible to filter and sort the results by using `YIELD`, `ORDER BY` and `WHERE`.
 
+.Show roles with ordering and filtering
+====
 [source, cypher, role=noplay]
 ----
 SHOW ROLES YIELD role
@@ -443,10 +472,6 @@ It is also possible to use `SKIP` and `LIMIT` to paginate the results.
 
 1+a|Rows: 3
 |===
-
-[NOTE]
-====
-The `SHOW ROLE name PRIVILEGES` command is found in xref:authentication-authorization/manage-privileges.adoc#access-control-list-privileges[Listing privileges].
 ====