fix build

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

Author: themr0c

assemblies/assembly-configuring-readonlyrootfilesystem.adoc

@@ -385,7 +385,7 @@ auth:
 `additionalScopes`::
 Optional for additional scopes.
 To add scopes for the application registration, uncomment and enter the list of scopes that you want to add.
-The default and mandatory value lists following scopes: 
+The default and mandatory value lists following scopes:
 * `openid`
 * `offline_access`
 * `profile`
@@ -463,6 +463,7 @@ This resolver looks up the user by matching their Microsoft email to the user en
 Configure the sign-in resolver to bypass the user provisioning requirement in the {product-short} software catalog.
 +
 WARNING: 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 for `MicrosoftGraphOrgEntityProvider` events.

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

@@ -1,6 +1,6 @@
 :_mod-docs-content-type: PROCEDURE
 
-[id="proc-configuring-an-rhdh-instance-with-tls-in-kubernetes_{context}"]
+[id="configuring-an-rhdh-instance-with-tls-in-kubernetes_{context}"]
 = Configuring an {product-very-short} instance with a TLS connection in Kubernetes
 
 You can configure a {product-very-short} instance with a Transport Layer Security (TLS) connection in a Kubernetes cluster, such as an Azure Red Hat OpenShift (ARO) cluster, any cluster from a supported cloud provider, or your own cluster with proper configuration. Transport Layer Security (TLS) ensures a secure connection for the {product-very-short} instance with other entities, such as third-party applications, or external databases. However, you must use a public Certificate Authority (CA)-signed certificate to configure your Kubernetes cluster.

modules/configuring/proc-configuring-an-rhdh-instance-with-tls-in-kubernetes.adoc

@@ -14,15 +14,21 @@ Your changes on this configuration might get reverted on {product-short} restart
 .Prerequisites
 * By using the {platform-cli-link}, you have access, with developer permissions, to the {platform-generic} cluster aimed at containing your {product-short} instance.
 
-include::snip-provisioning-your-custom-configuration-prerequisites-in-{context}-context.adoc[]
+ifeval::["{context}" == "setting-up-and-configuring-your-first-rhdh-instance"]
+include::snip-provisioning-your-custom-configuration-prerequisites-in-setting-up-and-configuring-your-first-rhdh-instance-context.adoc[]
+endif::[]
 
 .Procedure
-. For security, store your secrets as environment variables values in an {ocp-short} secret,
-rather than in clear text in your configuration files.
+. For security, store your secrets as environment variables values in an {ocp-short} secret, rather than in clear text in your configuration files.
 Collect all your secrets in the `secrets.txt` file, with one secret per line in `KEY=value` form.
 +
 --
-include::snip-provisioning-your-custom-configuration-secrets-step-in-{context}-context.adoc[]
+ifeval::["{context}" == "setting-up-and-configuring-your-first-rhdh-instance"]
+include::snip-provisioning-your-custom-configuration-secrets-steps-in-setting-up-and-configuring-your-first-rhdh-instance-context.adoc[]
+endif::[]
+ifeval::["{context}" != "setting-up-and-configuring-your-first-rhdh-instance"]
+include::snip-provisioning-your-custom-configuration-secrets-steps-in-default-context.adoc[]
+endif::[]
 --
 
 . Author your custom `{my-app-config-file}` file.
@@ -31,7 +37,7 @@ You need a custom `{my-app-config-file}` file to avoid the {product-short} insta
 When your custom `{my-app-config-file}` file is empty, {product-short} is using default values.
 +
 --
-include::snip-provisioning-your-custom-configuration-appconfig-step-in-{context}-context.adoc[]
+include::snip-provisioning-your-custom-configuration-appconfig-step-with-optional-steps-{optional-steps}d.adoc[]
 --
 
 . Author your custom `dynamic-plugins.yaml` file to enable plugins.
@@ -81,4 +87,9 @@ $ oc create secret generic {my-product-secrets} --from-file=secrets.txt --namesp
 Alternatively,
 link:https://docs.redhat.com/en/documentation/openshift_container_platform/{ocp-version}/html-single/nodes/index#nodes-pods-secrets-creating-web-console-secrets_nodes-pods-secrets[create the secret by using the web console].
 
-include::snip-provisioning-your-custom-configuration-next-steps-in-{context}-context.adoc[]
+ifeval::["{context}" == "setting-up-and-configuring-your-first-rhdh-instance"]
+include::snip-provisioning-your-custom-configuration-next-steps-in-setting-up-and-configuring-your-first-rhdh-instance-context.adoc[]
+endif::[]
+ifeval::["{context}" != "setting-up-and-configuring-your-first-rhdh-instance"]
+include::snip-provisioning-your-custom-configuration-next-steps-in-default-context.adoc[]
+endif::[]

modules/configuring/proc-provisioning-your-custom-configuration.adoc

@@ -28,8 +28,8 @@ backend:
 
 ** Optionally, enter your configuration such as:
 
-*** link:{authentication-book-url}[{authentication-book-title}].
-*** link:{authorization-book-url}[{authorization-book-title}].
-*** link:{customizing-book-url}[Customization].
-*** xref:configuring-an-rhdh-instance-with-tls-in-kubernetes[Configure your {ocp-short} integration].
+*** {authentication-book-link}[{authentication-book-title}].
+*** {authorization-book-link}[{authorization-book-title}].
+*** {customizing-book-link}[Customization].
+*** {customizing-book-link}#configuring-an-rhdh-instance-with-tls-in-kubernetes_{context}[Configure your {ocp-short} integration].
 

…p-for-the-platform-engineer-context.adoc …g-step-with-optional-steps-disabled.adocmodules/configuring/snip-provisioning-your-custom-configuration-appconfig-step-in-getting-started-with-rhdh-on-ocp-for-the-platform-engineer-context.adoc renamed to modules/configuring/snip-provisioning-your-custom-configuration-appconfig-step-with-optional-steps-disabled.adoc modules/configuring/snip-provisioning-your-custom-configuration-appconfig-step-in-getting-started-with-rhdh-on-ocp-for-the-platform-engineer-context.adoc renamed to modules/configuring/snip-provisioning-your-custom-configuration-appconfig-step-with-optional-steps-disabled.adoc

@@ -0,0 +1,8 @@
+.Next steps
+Consider provisioning additional config maps and secrets:
+
+* To use an external PostgreSQL database, {configuring-book-link}#configuring-external-postgresql-databases[provision your PostgreSQL database secrets].
+
+* To enable dynamic plugins, {installing-and-viewing-plugins-book-link}[provision your dynamic plugins config map].
+
+* To configure authorization by using external files, {authorization-book-link}#managing-authorizations-by-using-external-files[provision your RBAC policies config map].