Merge branch 'main' into rhdh-cli

Author: kadel

artifacts/attributes.adoc

@@ -99,6 +99,9 @@
 :release-notes-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/red_hat_developer_hub_release_notes/index
 :release-notes-book-title: {product} release notes
 
+:getting-started-on-ocp-for-the-platform-engineer-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/getting_started_with_red_hat_developer_hub_on_red_hat_openshift_container_platform_for_the_platform_engineer/index
+:getting-started-on-ocp-for-the-platform-engineer-book-title: Getting started with {product} on {ocp-brand-name} for the platform engineer
+
 :install-category-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/#Install
 :installing-on-ocp-book-title: Installing {product} on {ocp-short}
 :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
@@ -113,6 +116,10 @@
 :installing-in-air-gap-book-title: Installing {product} in an air-gapped environment
 :installing-in-air-gap-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_red_hat_developer_hub_in_an_air-gapped_environment/index
 
+:integrating-with-github-book-title: Integrating {product} with GitHub
+:integrating-with-github-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/integrating_red_hat_developer_hub_with_github/index
+
+
 :upgrade-category-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/#Upgrade
 :upgrading-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/upgrading_red_hat_developer_hub/index
 :upgrading-book-title: Upgrading {product}

assemblies/assembly-authenticating-with-microsoft-azure.adoc

@@ -1,13 +1,8 @@
 [id="assembly-authenticating-with-rhbk"]
 = Authenticating with {rhbk-brand-name} ({rhbk})
 
-To authenticate users with {rhbk-brand-name} ({rhbk}):
 
-. xref:enabling-authentication-with-rhbk[Enable the OpenID Connect (OIDC) authentication provider in RHDH].
-. xref:provisioning-users-from-rhbk-to-the-software-catalog[Provision users from {rhbk-brand-name} ({rhbk}) to the software catalog].
+include::modules/authentication/proc-enabling-user-authentication-with-rhbk.adoc[leveloffset=+1]
 
-include::modules/authentication/proc-enabling-authentication-with-rhbk.adoc[leveloffset=+1]
-
-include::modules/authentication/proc-provisioning-users-from-rhbk-to-the-software-catalog.adoc[leveloffset=+1]
 
 include::modules/authentication/proc-creating-a-custom-transformer-to-provision-users-from-rhbk-to-the-software-catalog.adoc[leveloffset=+1]

assemblies/assembly-authenticating-with-rhbk.adoc

@@ -6,7 +6,13 @@
 
 High availability (HA) is a system design approach that ensures a service remains continuously accessible, even during failures of individual components, by eliminating single points of failure. It introduces redundancy and failover mechanisms to minimize downtime and maintain operational continuity.
 
-{product} supports HA deployments on {ocp-brand-name} and {aks-name}. The HA deployments enable more resilient and reliable service availability across supported environments.
+{product} supports HA deployments on the following platforms:
+
+* {ocp-brand-name}
+* {aks-name} 
+* {eks-name}
+
+The HA deployments enable more resilient and reliable service availability across supported environments.
 
 In a single instance deployment, if a failure occurs, whether due to software crashes, hardware issues, or other unexpected disruptions, it would make the entire service unavailable, interrupting development workflows and access to key resources.
 

assemblies/assembly-configuring-high-availability.adoc

@@ -16,5 +16,5 @@ include::assembly-authenticating-with-rhbk.adoc[leveloffset=+1]
 include::modules/authentication/proc-enabling-user-authentication-with-github.adoc[leveloffset=+1]
 
 
-include::assembly-authenticating-with-microsoft-azure.adoc[leveloffset=+1]
+include::modules/authentication/proc-enabling-user-authentication-with-microsoft-azure.adoc[leveloffset=+1]
 

assemblies/assembly-enabling-authentication.adoc

@@ -9,7 +9,7 @@ Catalog provider plugins handle this task asynchronously.
 These plugins query the Identity Provider (IdP) for relevant user and group information, and create or update corresponding entities in the {product-short} catalog.
 Scheduled provisioning ensures that the catalog accurately reflects the users and groups in your organization.
 
-When a user attempts to access {product-short}, {product-short} redirects them to a configured authentication provider, such as xref:assembly-authenticating-with-rhbk[{rhbk-brand-name} ({rhbk})], xref:enabling-user-authentication-with-github[GitHub], or xref:assembly-authenticating-with-microsoft-azure[{azure-brand-name}].
+When a user attempts to access {product-short}, {product-short} redirects them to a configured authentication provider, such as xref:assembly-authenticating-with-rhbk[{rhbk-brand-name} ({rhbk})], xref:enabling-user-authentication-with-github[GitHub], or xref:enabling-user-authentication-with-microsoft-azure[{azure-brand-name}].
 This external IdP is responsible for authenticating the user.
 
 On successful authentication, the {product-short} authentication plugin, configured in your `{my-app-config-file}` file, processes the response from the IdP, resolves the identity in the {product-short} software catalog, and establishes a user session within {product-short}.

modules/authentication/con-understanding-authentication-and-user-provisioning.adoc

@@ -4,7 +4,7 @@
 To customize how {rhbk} users and groups are mapped to {product} entities, you can create a backend module that uses the `keycloakTransformerExtensionPoint` to provide custom user and group transformers for the Keycloak backend.
 
 .Prerequisites
-* You have xref:provisioning-users-from-rhbk-to-the-software-catalog[enabled provisioning users from {rhbk-brand-name} ({rhbk}) to the software catalog].
+* You have xref:enabling-user-authentication-with-rhbk[enabled provisioning users from {rhbk-brand-name} ({rhbk}) to the software catalog].
 
 .Procedure
 . Create a new backend module with the `yarn new` command.

modules/authentication/proc-creating-a-custom-transformer-to-provision-users-from-rhbk-to-the-software-catalog.adoc

@@ -61,7 +61,7 @@ Enter your GitHub organization name, such as `__<your_github_organization_name>_
 This plugin ingests GitHub users and groups to the {product-short} software catalog.
 +
 .`dynamic-plugins.yaml` file fragment
-[code,yaml]
+[source,yaml]
 ----
 plugins:
   - package: './dynamic-plugins/dist/backstage-plugin-catalog-backend-module-github-org'
@@ -207,3 +207,7 @@ WARNING: Use `dangerouslyAllowSignInWithoutUserInCatalog` to explore {product-sh
 .. Your {product-short} sign-in page displays *Sign in using GitHub* and the Guest user sign-in is disabled.
 .. Log in with a GitHub account.
 
+.Additional resources
+
+* link:{integrating-with-github-book-url}[{integrating-with-github-book-title}].
+