cleaned up formatting

Signed-off-by: Fabrice Flore-Thébault <[email protected]>

Author: themr0c

modules/authentication/proc-enabling-authentication-with-github.adoc

@@ -6,6 +6,7 @@ and provision the users and groups from GitHub to the {product-short} software c
 
 .Prerequisites
 * You link:{configuring-book-url}[added a custom {product-short} application configuration], and have sufficient permissions to modify it.
+
 * You have sufficient permissions in GitHub to create and manage a link:https://docs.github.com/en/apps/overview[GitHub App].
 
 .Procedure
@@ -22,8 +23,10 @@ Enter your {product-short} URL: `pass:c,a,q[{my-product-url}]`.
 
 Authorization callback URL::
 Enter your {product-short} authentication backend URL: `pass:c,a,q[{my-product-url}/api/auth/github/handler/frame]`.
+
 Webhook::
-Uncheck "Active", as this is not needed for authentication and catalog providers. 
+Uncheck "Active", as this is not needed for authentication and catalog providers.
+
 Organization permissions::
 Enable `Read-only` access to *Members*.
 
@@ -41,7 +44,7 @@ Select `Only on this account`.
 
 . To add your GitHub credentials to {product-short}, add the following key/value pairs to link:{configuring-dynamic-plugins-book-url}#provisioning-your-custom-configuration[your {product-short} secrets].
 You can use these secrets in the {product-short} configuration files by using their respective environment variable name.
-+
+
 `AUTHENTICATION_GITHUB_CLIENT_ID`::
 Enter the saved **Client ID**.
 
@@ -64,7 +67,6 @@ plugins:
   - package: './dynamic-plugins/dist/backstage-plugin-catalog-backend-module-github-org'
     disabled: false
 ----
-+
 
 . To provision GitHub users and groups to the {product-short} software catalog, add the `catalog.providers.githubOrg` section to your custom {product-short} `{my-app-config-file}` configuration file:
 +
@@ -90,8 +92,7 @@ catalog:
 
 `id`::
 Enter a stable identifier for this provider, such as `githuborg`.
-Entities from this provider will be associated with this identifier,
-therefore you should take care not to change it over time since that might lead to orphaned entities and/or conflicts.
+Entities from this provider will be associated with this identifier, therefore you should take care not to change it over time since that might lead to orphaned entities and/or conflicts.
 
 `githubUrl`::
 Enter the configured secret variable name: `${AUTHENTICATION_GITHUB_HOST_DOMAIN}`.

modules/integrating-with-github/proc-enabling-github-repository-discovery.adoc

@@ -7,14 +7,15 @@ When a repository contains a `catalog-info.yaml` file, {product-short} ingests t
 
 .Prerequisites
 * You link:{configuring-book-url}[added a custom {product-short} application configuration], and have sufficient permissions to modify it.
+
 * You have sufficient permissions in GitHub to create and manage a link:https://docs.github.com/en/apps/overview[GitHub App].
 
 .Procedure
 . To allow {product-short} to access the GitHub API, create a GitHub App.
 Opt for a GitHub App instead of an OAuth app to use fine-grained permissions, gain more control over which repositories the application can access, and use short-lived tokens.
 
 .. link:https://docs.github.com/en/apps/creating-github-apps/registering-a-github-app/registering-a-github-app[Register a GitHub App] with the following configuration:
-+
+
 GitHub App name::
 Enter a unique name identifying your GitHub App, such as `integrating-with-rhdh-__<GUID>__`.
 
@@ -77,7 +78,8 @@ Environments::::
 `Read & write` (if templates include GitHub Environments)
 
 Organization permissions::
-* Enable `Read-only` access to *Members*.
+Members:::
+`Read-only`
 
 Where can this GitHub App be installed?::
 Select `Only on this account`.
@@ -98,7 +100,7 @@ Select `Only on this account`.
 
 . To add your GitHub credentials to {product-short}, add the following key/value pairs to link:{configuring-dynamic-plugins-book-url}#provisioning-your-custom-configuration[your {product-short} secrets].
 You can use these secrets in the {product-short} configuration files by using their respective environment variable name.
-+
+
 `GITHUB_INTEGRATION_APP_ID`::
 Enter the saved **App ID**.
 `GITHUB_INTEGRATION_CLIENT_ID`::