Merge pull request ceph#54845 from zdover23/wip-doc-2023-12-09-radosgw-role-2

doc/radosgw: edit front matter - role.rst

Reviewed-by: Anthony D'Atri <[email protected]>

Author: zdover23

doc/radosgw/role.rst

@@ -2,9 +2,15 @@
  Role
 ======
 
-A role is similar to a user and has permission policies attached to it, that determine what a role can or can not do. A role can be assumed by any identity that needs it. If a user assumes a role, a set of dynamically created temporary credentials are returned to the user. A role can be used to delegate access to users, applications, services that do not have permissions to access some s3 resources.
-
-The following radosgw-admin commands can be used to create/ delete/ update a role and permissions associated with a role.
+A role is similar to a user. It has permission policies attached to it that
+determine what it can do and what it cannot do. A role can be assumed by any
+identity that needs it. When a user assumes a role, a set of
+dynamically-created temporary credentials are provided to the user. A role can
+be used to delegate access to users, to applications, and to services that do
+not have permissions to access certain S3 resources.
+
+The following ``radosgw-admin`` commands can be used to create or delete or
+update a role and the permissions associated with it.
 
 Create a Role
 -------------