stackabletech · fhennig · Dec 21, 2023 · Dec 14, 2023 · Dec 14, 2023 · Dec 14, 2023
diff --git a/antora.yml b/antora.yml
@@ -6,8 +6,8 @@ nav:
   - modules/concepts/nav.adoc
   - modules/demos/nav.adoc
   - modules/tutorials/nav.adoc
-  - modules/reference/nav.adoc
   - modules/operators/nav.adoc
+  - modules/reference/nav.adoc
   - modules/contributor/nav.adoc
   - modules/ROOT/nav2.adoc
 # The prerelease setting affects version sorting.
@@ -24,3 +24,6 @@ asciidoc:
     # use the attributes below to link to the CRD docs
     crd-docs-base-url: "https://crds.stackable.tech"
     crd-docs: "{crd-docs-base-url}/{crd-docs-version}"
+    # this attribute is an annoying little hack to make the versioned
+    # link accessible to the UI template.
+    page-crd-docs: "{crd-docs}"
diff --git a/modules/ROOT/pages/index.adoc b/modules/ROOT/pages/index.adoc
@@ -118,7 +118,7 @@ xref:operators:index.adoc[Operator overview]
 
 Read the CustomResourceDefinition (CRD) reference for all CRDs that are deployed by any Stackable operator.
 
-https://crds.stackable.tech/[CRD Reference]
+{crd-docs}[CRD Reference pass:[<i class="fa-solid fa-arrow-up-right-from-square fa-xs" style="margin-left: 5px; vertical-align: baseline;"></i>]]
 
 ++++
 </div>

diff --git a/modules/concepts/pages/authentication.adoc b/modules/concepts/pages/authentication.adoc
@@ -34,7 +34,7 @@ In a diagram it would look like this:
 
 image::image$authentication-overview.drawio.svg[]
 
-NOTE: For more details, look at the xref:reference:authenticationclass.adoc[AuthenticationClass reference] as well as the xref:tutorials:authentication_with_openldap.adoc[OpenLDAP tutorial].
+NOTE: Learn more in the xref:tutorials:authentication_with_openldap.adoc[OpenLDAP tutorial] and get a full overview of all the properties in the {crd-docs}/authentication.stackable.tech/authenticationclass/v1alpha1/#spec-provider-ldap[AuthenticationClass LDAP provider CRD reference].
 
 [#tls]
 === TLS
@@ -78,4 +78,4 @@ include::example$authenticationclass-static-secret.yaml[]
 == Further Reading
 
 * xref:tutorials:authentication_with_openldap.adoc[] tutorial
-* xref:reference:authenticationclass.adoc[] reference
+* {crd-docs}/authentication.stackable.tech/authenticationclass/v1alpha1/[AuthenticationClass CRD reference]
diff --git a/modules/concepts/pages/s3.adoc b/modules/concepts/pages/s3.adoc
@@ -205,4 +205,4 @@ credentials:
 
 == What's next
 
-Find details about the options of the S3 resource in the xref:reference:s3.adoc[S3 resources reference].
+Read the {crd-docs}/s3.stackable.tech/s3bucket/v1alpha1/[S3Bucket CRD reference] and the {crd-docs}/s3.stackable.tech/s3connection/v1alpha1/[S3Connection CRD reference].
diff --git a/modules/concepts/pages/service-discovery.adoc b/modules/concepts/pages/service-discovery.adoc
@@ -2,7 +2,7 @@
 :page-aliases: service_discovery.adoc
 
 // Abstract
-Stackable operators provide a _service discovery ConfigMap_ for each product instance that is deployed. This ConfigMap has the same name as the product instance and contains information about how to connect to the instance. The ConfigMap is used by other Operators to connect products together and can also be used by you, the user, to connect external software to Stackable-operated software.
+Stackable operators provide a _service discovery ConfigMap_ for each product instance that is deployed. **This ConfigMap has the same name as the product instance** and contains information about how to connect to the instance. The ConfigMap is used by other Operators to connect products together and can also be used by you, the user, to connect external software to Stackable-operated software.
 
 == Motivation
 
@@ -118,7 +118,7 @@ For Stackable managed services the Stackable Operators will take care of this, b
 
 Consult discovery ConfigMap documentation for specific products:
 
-* xref:druid:discovery.adoc[Apache Druid]
+* xref:druid:reference/discovery.adoc[Apache Druid]
 * xref:hdfs:discovery.adoc[Apache Hadoop HDFS]
 * xref:hive:discovery.adoc[Apache Hive]
 * xref:kafka:discovery.adoc[Apache Kafka]

diff --git a/modules/reference/examples/authenticationclass-ldap-full.yaml b/modules/reference/examples/authenticationclass-ldap-full.yaml
diff --git a/modules/reference/nav.adoc b/modules/reference/nav.adoc
@@ -1,3 +1 @@
-* xref:index.adoc[]
-** xref:authenticationclass.adoc[]
-** xref:s3.adoc[]
+- {crd-docs}[CRD Reference pass:[<i class="fa-solid fa-arrow-up-right-from-square fa-xs" style="margin-left: 5px; vertical-align: baseline;"></i>]]
diff --git a/modules/reference/pages/authenticationclass.adoc b/modules/reference/pages/authenticationclass.adoc
diff --git a/modules/reference/pages/index.adoc b/modules/reference/pages/index.adoc
diff --git a/modules/reference/pages/s3.adoc b/modules/reference/pages/s3.adoc
diff --git a/modules/tutorials/pages/authentication_with_openldap.adoc b/modules/tutorials/pages/authentication_with_openldap.adoc
@@ -351,7 +351,7 @@ The LDAP connection details only need to be written down once, in the Authentica
 == Further Reading
 
 - xref:concepts:authentication.adoc[Authentication concepts page]
-- xref:reference:authenticationclass.adoc[AuthenticationClass reference]
+* {crd-docs}/authentication.stackable.tech/authenticationclass/v1alpha1/[AuthenticationClass CRD reference]
 - xref:superset:getting_started/index.adoc[Getting started with the Stackable Operator for Apache Superset]
 - xref:trino:getting_started/index.adoc[Getting started with the Stackable Operator for Trino]
 // TODO Operator docs for LDAP
-Original file line number
+Diff line change
@@ Expand Up / @@ -118,7 +118,7 @@ xref:operators:index.adoc[Operator overview] @@
     Read the CustomResourceDefinition (CRD) reference for all CRDs that are deployed by any Stackable operator.
-    https://crds.stackable.tech/[CRD Reference]
+    {crd-docs}[CRD Reference pass:[<i class="fa-solid fa-arrow-up-right-from-square fa-xs" style="margin-left: 5px; vertical-align: baseline;"></i>]]
     ++++
     </div>
@@ Expand Down @@
Original file line number	Diff line number	Diff line change
Expand Up		@@ -205,4 +205,4 @@ credentials:

		== What's next

		Find details about the options of the S3 resource in the xref:reference:s3.adoc[S3 resources reference].
		Read the {crd-docs}/s3.stackable.tech/s3bucket/v1alpha1/[S3Bucket CRD reference] and the {crd-docs}/s3.stackable.tech/s3connection/v1alpha1/[S3Connection CRD reference].