RHIDP-8623 - [Doc] Create a quickstart for the developer persona (#1473)

* RHIDP-8623 - [Doc] Create a quickstart for the developer persona

* RHIDP-8623 - [Doc] Create a quickstart for the developer persona

* RHIDP-8623 - [Doc] Create a quickstart for the developer persona

* Update con-using-rbac-with-quickstarts.adoc

* RHIDP-8623 - [Doc] Create a quickstart for the developer persona

* RHIDP-8623 - [Doc] Create a quickstart for the developer persona

* RHIDP-8623 - [Doc] Create a quickstart for the developer persona

Author: Gerry-Forde

assemblies/assembly-configuring-the-quickstarts.adoc

@@ -11,3 +11,5 @@ include::modules/configuring-the-quickstarts/proc-customize-rhdh-quickstart.adoc
 include::modules/configuring-the-quickstarts/proc-disabling-rhdh-quickstart.adoc[leveloffset=+2]
 
 include::modules/configuring-the-quickstarts/proc-starting-and-completing-modules-in-quickstarts.adoc[leveloffset=+1]
+
+include::modules/configuring-the-quickstarts/con-using-rbac-with-quickstarts.adoc[leveloffset=+1]

modules/configuring-the-quickstarts/con-using-rbac-with-quickstarts.adoc

@@ -0,0 +1,48 @@
+:_mod-docs-content-type: CONCEPT
+
+[id="using-rbac-with-quickstarts_{context}"]
+= About access to Quickstarts with Role-Based Access Control (RBAC)
+You can control user access to Quickstarts by using RBAC to define user roles that use the following logic in your RBAC configuration:
+
+* If RBAC is enabled (`permission.enabled: true`), the system determines user roles based on permissions, as follows:
+** Users with `policy.entity.create` permission are assigned the admin role.
+** Users without this permission are assigned the developer role.
+
+[NOTE]
+====
+If RBAC is disabled (`permission.enabled: false`) or not configured, users are assumed to be platform engineers setting up {product} ({product-very-short}) and are assigned the admin role.
+====
+
+The following two roles are supported for defining access to Quickstarts:
+
+admin:: Platform engineers, administrators, and users with elevated permissions
+developer:: Regular developers and users with standard permissions
+
+The following behavior applies when you use RBAC to assign roles for your Quickstarts:
+
+* Quickstart items without a `roles` property default to the admin role.
+* Items can specify multiple roles, for example, admin and developer.
+* Users see Quickstart items that match their assigned role.
+
+.Example configuring RBAC for a Quickstart in your {my-app-config-file} file
+
+[source,yaml]
+----
+permission:
+  enabled: true
+
+app:
+  quickstart:
+    - title: 'Platform Configuration'
+      titleKey: steps.platformConfiguration.title
+      roles: ['admin']
+      # Only admins see this
+    - title: 'Getting Started as Developer'
+      titleKey: steps.gettingStarted.title
+      roles: ['developer']
+      # Only developers see this
+    - title: 'Universal Welcome Guide'
+      titleKey: steps.universalWelcome.title
+      roles: ['admin', 'developer']
+      # Both user roles see this
+----

modules/configuring-the-quickstarts/proc-customize-rhdh-quickstart.adoc

@@ -18,25 +18,29 @@ app:
     - title: 'Welcome to {product-short}'
       description: 'Learn the basics of navigating the {product-short} interface'
       icon: 'home'
+      roles: ['admin', 'developer'] # Show to both roles
       cta:
         text: 'Get Started'
         link: '/catalog'
     - title: 'Create Your First Component'
       description: 'Follow our guide to register your first software component'
       icon: 'code'
+      roles: ['admin', 'developer'] # Show to both roles
       cta:
         text: 'Create Component'
         link: '/catalog-import'
     - title: 'Explore Templates'
       description: 'Discover available software templates to bootstrap new projects'
       icon: 'template'
+      roles: ['admin', 'developer'] # Show to both roles
       cta:
         text: 'Browse Templates'
         link: '/create'
 ----
 `title`:: Enter the display title for the quickstart step.
 `description`:: Enter the brief description of what the step covers.
 `icon`:: (Optional) Enter the icon identifier (supports Material UI icons).
+`roles`:: (Optional): Enter an array of user roles that should see this quickstart item. Supported values: `['admin', 'developer']`. If not specified, defaults to `['admin']`
 `cta`::
 `text`::: (Optional) Enter the CTA button text.
 `link`::: (Optional) Enter the CTA target URL or route.