doc/radosgw: edit front matter - role.rst

Clarify the front matter in doc/radosgw/role.rst.

Co-authored-by: Anthony D'Atri <anthony.datri@gmail.com>
Signed-off-by: Zac Dover <zac.dover@proton.me>

diff --git a/doc/radosgw/role.rst b/doc/radosgw/role.rst
index 3ef78d8d209cf5fba7c8bd42a61559c0ef37bcea..029d8b778d63a852fa7e5307b77807def504ee19 100644 (file)
--- a/doc/radosgw/role.rst
+++ b/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
 -------------