RHIDP-5483: Update Authorization Preface (#1052)

* RHIDP-5483: Update Authorization Preface

* RHIDP-5483: Update Authorization Abstract

* RHIDP-5483: Apply reviewer suggestions

Author: linfraze

assemblies/assembly-configuring-authorization-in-rhdh.adoc

@@ -1,26 +1,18 @@
 [id='configuring-authorization-in-rhdh']
 = Configuring authorization in {product}
 
-In link:{authorization-book-url}[{authentication-book-title}], you learnt how to authenticate users to {product}.
-{product-short} knowns who the users are.
+Administrators can authorize users to perform actions and define what users can do in {product-short}.
 
-In this book, learn how to authorize users to perform actions in {product-short}.
-Define what users can do in {product-short}.
+Role-based access control (RBAC) is a security concept that defines how to control access to resources in a system by specifying a mapping between users of the system and the actions that those users can perform on resources in the system.
+You can use RBAC to define roles with specific permissions and then assign the roles to users and groups.
 
-Role-Based Access Control (RBAC) is a security concept that controls access to resources in a system, and specifies a mapping between users of the system, and the actions they can perform on resources in the system.
-You define roles with specific permissions, and then assign the roles to users and groups.
+RBAC on {product-short} is built on top of the Permissions framework, which defines RBAC policies in code. Rather than defining policies in code, you can use the {product-short} RBAC feature to define policies in a declarative fashion by using a simple CSV based format. You can define the policies by using {product-short} web interface or REST API instead of editing the CSV directly.
 
-RBAC on {product-short} is built on top of the Permissions framework, which defines RBAC policies in code.
-Rather than defining policies in code,
-the {product-short} RBAC feature allows you
-to define policies in a declarative fashion using a simple CSV based format.
-You can define the policies by using {product-short} web interface or REST API, rather than editing the CSV directly.
+An administrator can define authorizations in {product-short} by taking the following steps:
 
-To define authorizations in {product-short}:
+. Enable the RBAC feature and give authorized users access to the feature.
 
-. The {product-short} administrator enables and gives access to the RBAC feature.
-
-. You define your roles and policies by combining the following methods:
+. Define roles and policies by combining the following methods:
 
 * The {product-short} policy administrator uses the {product-short} web interface or REST API.
 * The {product-short} administrator edits the main {product-short} configuration file.
@@ -59,4 +51,3 @@ include::modules/authorization/con-user-stats-rhdh.adoc[leveloffset=+1]
 
 
 include::modules/authorization/proc-download-user-stats-rhdh.adoc[leveloffset=+2]
-

titles/authentication/master.adoc

@@ -10,4 +10,3 @@ include::artifacts/attributes.adoc[]
 //{abstract}
 
 include::assemblies/assembly-enabling-authentication.adoc[]
-

titles/authorization/master.adoc

@@ -3,7 +3,7 @@ include::artifacts/attributes.adoc[]
 :imagesdir: images
 :title: Authorization in {product}
 :subtitle: Configuring authorization by using role based access control (RBAC) in {product}
-:abstract: As a {product} platform engineer, you can manage authorizations of other users by using role based access control (RBAC) to meet the specific needs of your organization.
+:abstract: {product} administrators can use role-based access control (RBAC) to manage authorizations of other users.
 //[id="{context}"]
 //= {title}