Merge branch 'main' into HACDOCS-1157

Author: themr0c

.asciidoctorconfig

@@ -9,7 +9,6 @@ include::{asciidoctorconfigdir}/artifacts/attributes.adoc[]
 :chapter-signifier: Chapter
 :docinfo: shared
 :docinfodir: {asciidoctorconfigdir}/.asciidoctor
-:doctype: book
 :sectnumlevels: 5
 :sectnums:
 :source-highlighter: coderay

artifacts/attributes.adoc

@@ -88,9 +88,15 @@
 :authorization-book-url: https://docs.redhat.com/documentation/en-us/red_hat_developer_hub/{product-version}/html-single/authorization/index
 :authorization-book-title: Authorization
 
+:installing-on-osd-on-gcp-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_red_hat_developer_hub_on_openshift_dedicated_on_google_cloud_platform/index
+:installing-on-osd-on-gcp-book-title: Installing {product} on {gcp-brand-name} on {gcp-brand-name}
+
 :installing-on-ocp-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_red_hat_developer_hub_on_openshift_container_platform/index
 :installing-on-ocp-book-title: Installing {product} on {ocp-short}
 
+:installing-on-gke-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_red_hat_developer_hub_on_google_kubernetes_engine/index
+:installing-on-gke-book-title: Installing {product} on {gke-brand-name}
+
 :installing-on-eks-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_red_hat_developer_hub_on_amazon_elastic_kubernetes_service/index
 :installing-on-eks-book-title: Installing {product} on {eks-brand-name}
 

assemblies/assembly-about-rhdh.adoc

@@ -20,3 +20,6 @@ Use {product} to simplify decision-making through a selection of internally appr
 
 
 include::modules/about/con-benefits-of-rhdh.adoc[leveloffset=+1]
+include::modules/about/ref-supported-platforms.adoc[leveloffset=+1]
+include::modules/about/ref-rhdh-sizing.adoc[leveloffset=+1]
+include::modules/about/ref-customer-support-info.adoc[leveloffset=+1]

assemblies/assembly-audit-log.adoc

@@ -45,4 +45,4 @@ include::modules/observe/ref-audit-log-scaffolder-events.adoc[leveloffset=+2]
 
 include::modules/observe/ref-audit-log-catalog-events.adoc[leveloffset=+2]
 
-include::modules/observe/ref-audit-log-file-rotation-overview.adoc[]
+include::modules/observe/ref-audit-log-file-rotation-overview.adoc[]

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

@@ -16,37 +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::assembly-managing-authorizations-by-using-the-rest-api.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]
@@ -55,9 +50,6 @@ 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]
 
 

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-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,4 +13,4 @@ This integration requires the deployment of {product-short} on {aks-short} using
 * The Helm chart
 * The {product} Operator
 
-//include::modules/admin/proc-rhdh-monitoring-logging-aks.adoc[leveloffset=+1] // moving observe category related content to new titles: RHIDP-4814
+//include::modules/admin/proc-rhdh-monitoring-logging-aks.adoc[leveloffset=+1] // moving observe category related content to new titles: RHIDP-4814

assemblies/assembly-running-rhdh-behind-a-proxy.adoc

@@ -6,8 +6,9 @@ You can run the {product-very-short} application behind a corporate proxy by set
 * `HTTP_PROXY`: Denotes the proxy to use for HTTP requests.
 * `HTTPS_PROXY`: Denotes the proxy to use for HTTPS requests.
 
-Additionally, you can set the `NO_PROXY` environment variable to exclude certain domains from proxying. The variable value is a comma-separated list of hostnames that do not require a proxy to get reached, even if one is specified.
+Additionally, set the `NO_PROXY` environment variable to bypass the proxy for certain domains. The variable value is a comma-separated list of hostnames or IP addresses that can be accessed without the proxy, even if one is specified.
 
+include::modules/admin/procedure-understanding-no-proxy.adoc[leveloffset=+1]
 
 include::modules/admin/proc-configuring-proxy-in-helm-deployment.adoc[leveloffset=+1]
 include::modules/admin/proc-configuring-proxy-in-operator-deployment.adoc[leveloffset=+1]

build/scripts/build-ccutil.sh

@@ -36,7 +36,7 @@ for t in $(find titles -name master.adoc | sort -uV | grep -E -v "${EXCLUDED_TIT
     CMD="podman run --interactive --rm --tty \
           --volume "$(pwd)":/docs:Z \
           --workdir "/docs/$d" \
-          quay.io/ivanhorvath/ccutil:amazing ccutil compile --format html-single --lang en-US";
+          quay.io/ivanhorvath/ccutil:amazing ccutil compile --format html-single --lang en-US --doctype article";
     echo -e -n "\nBuilding $t into $dest ...\n  ";
     echo "${CMD}" | sed -r -e "s/\  +/ \\\\\n    /g"
     $CMD