Work on consistency

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

Author: themr0c

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

@@ -73,9 +73,7 @@ plugins:
 
 . 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:
 +
---
 [id=githubProviderId]
-.`{my-app-config-file}` fragment with mandatory `catalog.providers.githubOrg` fields
 [source,yaml]
 ----
 catalog:
@@ -111,12 +109,9 @@ Enter your schedule timeout, in the ISO duration or "human duration" format.
 
 `schedule.initialDelay`::
 Enter your schedule initial delay, in the ISO duration or "human duration" format.
---
 
 . To set up the GitHub authentication provider, add the `auth.providers.github` section to your `{my-app-config-file}` file:
 +
---
-.`{my-app-config-file}` file fragment with mandatory fields to enable authentication with GitHub
 [source,yaml]
 ----
 auth:
@@ -142,11 +137,10 @@ Enter the configured secret variable name: `$\{GITHUB_CLIENT_SECRET}`.
 Enter `github` to enable the GitHub provider as your {product-short} sign-in provider.
 +
 Optional: Consider adding optional fields.
-ifeval::[{optional-steps} == 'disable']
+ifeval::["{optional-steps}" == "disable"]
 See {configuring-book-link}[{configuring-book-title}].
 endif::[]
-ifeval::[{optional-steps} == 'enable']
-+
+ifeval::["{optional-steps}" == "enable"]
 [source,yaml,subs="+quotes"]
 ----
 auth:
@@ -203,7 +197,6 @@ Configure the sign-in resolver to bypass the user provisioning requirement in th
 Use `dangerouslyAllowSignInWithoutUserInCatalog` to explore {product-short} features, but do not use it in production.
 ====
 endif::[]
---
 
 .Verification
 . To verify user and group provisioning, check the console logs.

modules/authentication/proc-enabling-user-authentication-with-microsoft-azure.adoc

@@ -145,10 +145,10 @@ In a large organization, user provisioning might take a long time, therefore avo
 Enter the schedule initial delay in the ISO duration or human duration format.
 +
 Optional: Consider adding optional fields.
-ifeval::[{optional-steps} == 'disable']
+ifeval::["{optional-steps}" == "disable"]
 See {configuring-book-link}[{configuring-book-title}].
 endif::[]
-ifeval::[{optional-steps} == 'enable']
+ifeval::["{optional-steps}" == "enable"]
 [id=authority]
 `authority`::
 Enter your link:https://learn.microsoft.com/en-us/graph/deployments#app-registration-and-token-service-root-endpoints[{azure-short} authority URL], when different from the default: `\https://login.microsoftonline.com`.
@@ -384,11 +384,10 @@ Enter the configured secret variable name: `$\{AUTHENTICATION_AZURE_TENANT_ID}`.
 Enter `microsoft` to set the {azure-short} provider as your {product-short} sign-in provider.
 +
 Optional: Consider adding optional fields.
-ifeval::[{optional-steps} == 'disable']
+ifeval::["{optional-steps}" == "disable"]
 See {configuring-book-link}[{configuring-book-title}].
 endif::[]
-ifeval::[{optional-steps} == 'enable']
-
+ifeval::["{optional-steps}" == "enable"]
 `domainHint`::
 Optional for single-tenant applications.
 You can reduce login friction for users with accounts in multiple tenants by automatically filtering out accounts from other tenants.

modules/authentication/proc-enabling-user-authentication-with-rhbk.adoc

@@ -83,10 +83,10 @@ Enter the realm name to provision users, such as `master`.
 Enter the realm name to authenticate users, such as `master`.
 +
 Optional: Consider adding optional fields.
-ifeval::[{optional-steps} == 'disable']
+ifeval::["{optional-steps}" == "disable"]
 See {configuring-book-link}[{configuring-book-title}].
 endif::[]
-ifeval::[{optional-steps} == 'enable']
+ifeval::["{optional-steps}" == "enable"]
 `userQuerySize`::
 Enter the user count to query simultaneously.
 Default value: `100`.
@@ -162,10 +162,7 @@ catalog:
 endif::[]
 
 . To set up the {rhbk} authentication provider in your {product-short} custom configuration, edit your custom {product-short} ConfigMap such as `app-config-rhdh`, and add the following lines to the `{my-app-config-file}` content:
-
-.. Add mandatory fields:
 +
-.`{my-app-config-file}` fragment with mandatory fields to enable authentication with {rhbk}
 [source,yaml]
 ----
 auth:
@@ -198,10 +195,10 @@ If `prompt: auto` is not set, the identity provider defaults to `prompt: none`,
 ====
 +
 Optional: Consider adding optional fields.
-ifeval::[{optional-steps} == 'disable']
+ifeval::["{optional-steps}" == "disable"]
 See {configuring-book-link}[{configuring-book-title}].
 endif::[]
-ifeval::[{optional-steps} == 'enable']
+ifeval::["{optional-steps}" == "enable"]
 `callbackUrl`::
 {rhbk} callback URL.
 +