RHIDP-7794 Clarify authenticating and integrating with GitHub (#1224)

Co-authored-by: Jessica He <[email protected]>
Co-authored-by: Kim Tsao <[email protected]>
Co-authored-by: Priyanka Abel <[email protected]>

Author: 4 people

assemblies/assembly-authenticating-with-github.adoc

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

assemblies/assembly-enabling-authentication.adoc

@@ -0,0 +1,8 @@
+[id='integrating-with-github']
+= Integrating with GitHub in {product}
+
+include::modules/integrating-with-github/proc-enabling-github-repository-discovery.adoc[leveloffset=+1]
+
+
+include::assembly-bulk-importing-from-github.adoc[leveloffset=+1]
+

assemblies/assembly-integrating-with-github.adoc

@@ -7,8 +7,7 @@ include::../assembly-topology-plugin-configure.adoc[leveloffset=+1]
 
 include::../assembly-managing-labels-annotations-topology.adoc[leveloffset=+1]
 
-include::../assembly-bulk-importing-from-github.adoc[leveloffset=+1]
 
 include::../assembly-using-servicenow.adoc[leveloffset=+1]
 
-include::../assembly-using-kubernetes-custom-actions.adoc[leveloffset=+1]
+include::../assembly-using-kubernetes-custom-actions.adoc[leveloffset=+1]

assemblies/dynamic-plugins/assembly-install-topology-plugin.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:authenticating-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:assembly-authenticating-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}.