Merge branch 'release-1.3' into cherry-pick-695-to-release-1.3

Author: themr0c

artifacts/attributes.adoc

@@ -11,8 +11,8 @@
 :product-short: Developer Hub
 :product-very-short: RHDH
 :product-version: 1.3
-:product-bundle-version: 1.3.1
-:product-chart-version: 1.3.1
+:product-bundle-version: 1.3.0
+:product-chart-version: 1.3.0
 :product-backstage-version: 1.29.2
 :rhdeveloper-name: Red Hat Developer
 :rhel: Red Hat Enterprise Linux

assemblies/assembly-about-rhdh.adoc

@@ -19,4 +19,4 @@ This platform is driven by a centralized software catalog, providing efficiency
 Use {product} to simplify decision-making through a selection of internally approved tools, programming languages, and developer resources within a self-managed portal.
 
 
-include::modules/discover/con-benefits-of-rhdh.adoc[leveloffset=+1]
+include::modules/about/con-benefits-of-rhdh.adoc[leveloffset=+1]

assemblies/assembly-audit-log.adoc

@@ -33,14 +33,14 @@ Audit logs are not forwarded to the internal log store by default because this d
 * For a complete list of fields that a {product-short} audit log can include, see xref:ref-audit-log-fields.adoc_{context}[]
 * For a list of scaffolder events that a {product-short} audit log can include, see xref:ref-audit-log-scaffolder-events.adoc_{context}[]
 
-include::modules/getting-started/con-audit-log-config.adoc[leveloffset=+1]
+include::modules/observe/con-audit-log-config.adoc[leveloffset=+1]
 
-include::modules/getting-started/proc-audit-log-view.adoc[leveloffset=+1]
+include::modules/observe/proc-audit-log-view.adoc[leveloffset=+1]
 
-include::modules/getting-started/ref-audit-log-fields.adoc[leveloffset=+2]
+include::modules/observe/ref-audit-log-fields.adoc[leveloffset=+2]
 
-include::modules/getting-started/ref-audit-log-scaffolder-events.adoc[leveloffset=+2]
+include::modules/observe/ref-audit-log-scaffolder-events.adoc[leveloffset=+2]
 
-include::modules/getting-started/ref-audit-log-catalog-events.adoc[leveloffset=+2]
+include::modules/observe/ref-audit-log-catalog-events.adoc[leveloffset=+2]
 
-include::modules/getting-started/ref-audit-log-file-rotation-overview.adoc[leveloffset=+1]
+include::modules/observe/ref-audit-log-file-rotation-overview.adoc[leveloffset=+1]

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

@@ -16,34 +16,32 @@ 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.
 
-To apply RBAC in {product-short}:
+To define authorizations in {product-short}:
 
-. The {product-short} administrator sets up the RBAC feature:
-.. Enable the RBAC feature
-.. Configure Policy Administrators
+. The {product-short} administrator enables and gives access to the RBAC feature.
 
-. The {product-short} policy administrator configures your RBAC policies:
-.. Define roles with specific permissions
-.. Assign the roles to users and groups
+. You define your 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.
+* The {product-short} administrator edits external files.
 
 include::modules/authorization/proc-enabling-the-rbac-plugin.adoc[leveloffset=+1]
 
 
-include::assembly-managing-authorizations-by-using-the-rhdh-web-ui.adoc[leveloffset=+1]
+include::modules/authorization/proc-determining-permission-policy-and-role-configuration-source.adoc[leveloffset=+1]
 
 
-include::modules/authorization/ref-rbac-permission-policies.adoc[leveloffset=+1]
+include::assembly-managing-authorizations-by-using-the-rhdh-web-ui.adoc[leveloffset=+1]
 
 
-include::modules/authorization/con-rbac-config-permission-policies.adoc[leveloffset=+2]
+include::assembly-managing-authorizations-by-using-the-rest-api.adoc[leveloffset=+1]
 
 
-include::modules/authorization/con-rbac-config-permission-policies-external-file.adoc[leveloffset=+3]
+include::assembly-managing-authorizations-by-using-external-files.adoc[leveloffset=+1]
 
-include::modules/authorization/proc-mounting-the-policy-csv-file-using-the-operator.adoc[leveloffset=+4]
 
-include::modules/authorization/proc-mounting-the-policy-csv-file-using-helm.adoc[leveloffset=+4]
+include::modules/authorization/ref-rbac-permission-policies.adoc[leveloffset=+1]
 
 
 include::modules/authorization/con-rbac-conditional-policies-rhdh.adoc[leveloffset=+1]
@@ -52,20 +50,8 @@ include::modules/authorization/con-rbac-conditional-policies-rhdh.adoc[leveloffs
 include::modules/authorization/ref-rbac-conditional-policy-definition.adoc[leveloffset=+2]
 
 
-include::modules/authorization/proc-rbac-config-conditional-policy-file.adoc[leveloffset=+2]
-
-
-
 include::modules/authorization/con-user-stats-rhdh.adoc[leveloffset=+1]
 
 
 include::modules/authorization/proc-download-user-stats-rhdh.adoc[leveloffset=+2]
 
-
-include::modules/authorization/con-rbac-rest-api.adoc[leveloffset=+1]
-
-
-include::modules/authorization/proc-rbac-send-request-rbac-rest-api.adoc[leveloffset=+2]
-
-
-include::modules/authorization/ref-rbac-rest-api-endpoints.adoc[leveloffset=+2]

assemblies/assembly-managing-authorizations-by-using-external-files.adoc

@@ -0,0 +1,10 @@
+[id='managing-authorizations-by-using-external-files']
+= Managing authorizations by using external files
+
+To automate {product} maintenance, you can configure permissions and roles in external files, before starting {product-short}.
+
+
+include::modules/authorization/proc-defining-authorizations-in-external-files-by-using-the-operator.adoc[leveloffset=+1]
+
+include::modules/authorization/proc-defining-authorizations-in-external-files-by-using-helm.adoc[leveloffset=+1]
+

assemblies/assembly-managing-authorizations-by-using-the-rest-api.adoc

@@ -0,0 +1,25 @@
+[id='managing-authorizations-by-using-the-rest-api']
+= Managing authorizations by using the REST API
+
+To automate the maintenance of {product} permission policies and roles, you can use {product-short} role-based access control (RBAC) REST API.
+
+You can perform the following actions with the REST API:
+
+* Retrieve information about:
+** All permission policies
+** Specific permission policies
+** Specific roles
+** Static plugins permission policies
+* Create, update, or delete:
+** Permission policy
+** Role
+
+
+include::modules/authorization/proc-sending-request-to-the-rbac-rest-api-by-using-curl.adoc[leveloffset=+1]
+
+
+include::modules/authorization/proc-sending-request-to-the-rbac-rest-api-by-using-a-rest-client.adoc[leveloffset=+1]
+
+
+include::modules/authorization/ref-rbac-rest-api-endpoints.adoc[leveloffset=+1]
+

assemblies/assembly-managing-authorizations-by-using-the-rhdh-web-ui.adoc

@@ -1,4 +1,4 @@
-[id='proc-rbac-ui-manage-roles_{context}']
+[id='managing-authorizations-by-using-the-web-ui']
 = Managing role-based access controls (RBAC) using the {product} Web UI
 
 Policy administrators can use the {product-short} web interface (Web UI) to allocate specific roles and permissions to individual users or groups. Allocating roles ensures that access to resources and functionalities is regulated across the {product-short}.

assemblies/assembly-rhdh-integration-aks.adoc

@@ -13,7 +13,4 @@ This integration requires the deployment of {product-short} on {aks-short} using
 * The Helm chart
 * The {product} Operator
 
-.Additional resources
-* link:{authentication-book-url}#assembly-authenticating-with-microsoft-azure[Authenticating with {azure-brand-name}]
-
-include::modules/admin/proc-rhdh-monitoring-logging-aks.adoc[leveloffset=+1]
+//include::modules/admin/proc-rhdh-monitoring-logging-aks.adoc[leveloffset=+1] // moving observe category related content to new titles: RHIDP-4814

assemblies/assembly-rhdh-integration-aws.adoc

@@ -12,5 +12,5 @@ The integration with {aws-short} requires the deployment of {product-short} in {
 * The Helm chart
 * The {product} Operator
 
-include::modules/admin/proc-rhdh-monitoring-logging-aws.adoc[leveloffset=+1]
+//include::modules/admin/proc-rhdh-monitoring-logging-aws.adoc[leveloffset=+1]// moving observe category related content to new titles: RHIDP-4814
 

assemblies/assembly-rhdh-observability.adoc

@@ -3,15 +3,13 @@
 = Enabling observability for {product} on {ocp-short}
 :context: assembly-rhdh-observability
 
-toc::[]
-
 // Metrics
 In {ocp-short}, metrics are exposed through an HTTP service endpoint under the `/metrics` canonical name. You can create a `ServiceMonitor` custom resource (CR) to scrape metrics from a service endpoint in a user-defined project.
 
-include::modules/observability/proc-admin-enabling-metrics-ocp-helm.adoc[leveloffset=+1]
-include::modules/observability/proc-admin-enabling-metrics-ocp-operator.adoc[leveloffset=+1]
+include::modules/observe/proc-admin-enabling-metrics-ocp-operator.adoc[leveloffset=+1]
+include::modules/observe/proc-admin-enabling-metrics-ocp-helm.adoc[leveloffset=+1]
+
 
 [role="_additional-resources"]
-[id="additional-resources_{context}"]
-== Additional resources
+.Additional resources
 * link:https://docs.openshift.com/container-platform/latest/observability/monitoring/managing-metrics.html[{ocp-short} - Managing metrics]