Role wizard page updates

docs/admin-gui/role-wizard/index.adoc

@@ -1,31 +1,33 @@
-= Resource wizard
+= Role wizard
 :page-toc: top
 :page-since: "4.7"
 
-Role wizard is available from midPoint version 4.6.
+Role wizard provides user interface for creation of roles to users that are not so experienced in daily work with midPoint, such as helpdesk or backoffice operators.
 
-Some wizard panels are configurable, for more information see xref:/midpoint/reference/admin-gui/admin-gui-config/#wizard-panels[Wizard panels].
+The wizard simplifies the process of creation of new role. The user interface guides the user through individual steps of role creation. Each step is defined by specific panel. This simplification helps users to perform their tasks faster and with fewer errors.
+
+To keep the wizard interface simple for users, the wizard does not provide all options and flexibility of midPoint.
 
-New UI takes form of some panels with choice for specific parts of resource configuration. Specific part of configuration is represented by a wizard with steps.
+So far, midPoint supports only creation of _Application role_, _Business role_. Standard user interface is used for modification of these roles.
 
-Midpoint support role wizard only for _Application role_ and _Business role_.
+Some wizard panels are configurable, for more information see xref:/midpoint/reference/admin-gui/admin-gui-config/#wizard-panels[Wizard panels].
 
 == Application role wizard
-In the role wizard for the application role, we can select _Application_, set the new role's basic attributes, add users to the new role, and create a inducement for resource with associations and mappings.
+In the role wizard for the application role, we can select _Application_, set the new role's basic attributes, add users to the new role, and create inducement for resource with associations and mappings.
 
-We can skip the application selection and add a inducement in the step later.
+We can skip the application selection and add inducement in the step later.
 
 .Application catalog
 image::arw-step-1-select-application.png[Application catalog,100%]
 
 .Basic attributes of role
 image::arw-step-1-basic.png[Basic attributes of role,100%]
 
-The role is created after submitting the attributes. Next, we see titles with additional possibilities.
+The role is created after submitting attributes. Next, we see tiles with additional configuration options.
 
 image::arw-step-2-tiles.png[Configuration possibilities,100%]
 
-We can add governance users, member users, create a inducement for a resource or view the currently created role.
+We can add governance users, member users, create inducement for a resource or view the currently created role.
 
 {empty} +
 Members panels:
@@ -36,7 +38,7 @@ Members panels:
 |===
 
 {empty} +
-Configuration provisioning:
+Configuration of provisioning:
 
 [%autowidth, cols="1a,1a", frame=none, grid=none, role=center]
 |===
@@ -48,7 +50,7 @@ Configuration provisioning:
 |===
 
 == Business role wizard
-In the role wizard for the business role, we can set the new role's basic attributes,select _Application roles_ and add users to the new role.
+In the role wizard for the business role, we can set the new role's basic attributes, choose _Application roles_ to be included in the business role and add users to the new role.
 
 .Basic attributes of role
 image::brw-step-1-basic.png[Basic attributes of role,100%]
@@ -60,9 +62,9 @@ image::brw-step-1-select-application-role.png[Application role catalog,100%]
 
 Adding users is done through the same panels as in the application role wizard.
 
-== Wizard for existing role
-
-If we want to create a new inducement for a resource, only then we can view wizard for the provisioning configuration.
+== Sub-wizards
+Some panels of the role wizard can be invoked also during configuration of already prepared application role.
+If we want to create or modify an inducement for resource, the sub-wizard for provisioning configuration is invoked.
 
 .Role detail
 image::role-details.png[Role detail, 100%]