stackabletech · fhennig · Dec 21, 2023 · Dec 14, 2023 · Dec 14, 2023 · Dec 14, 2023
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]
 
 ++++
 </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/nav.adoc b/modules/reference/nav.adoc
@@ -1,3 +1 @@
-* xref:index.adoc[]
-** xref:authenticationclass.adoc[]
-** xref:s3.adoc[]
+* xref:index.adoc[]
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
@@ -1,3 +1,7 @@
-# Reference
+# CRD reference
+:page-aliases: s3.adoc, authenticationclass.adoc
 
-Reference for common objects and configuration fragments across the platform.
+// Let's not link individual CRDs etc. here, just point to the landing page of the CRD docs and that's it.
+You can find CRD reference documentation at {crd-docs}.
+
+There you will find documentation on all properties of all the CRDs that are deployed by the Stackable operators.
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
diff --git a/supplemental-ui/partials/navbar.hbs b/supplemental-ui/partials/navbar.hbs
@@ -6,6 +6,7 @@
         <a class="drop-down-item" href="{{{ relativize (versioned "home" page "concepts/index.html") }}}">Concepts</a>
         <a class="drop-down-item" href="{{{ relativize (versioned "home" page "demos/index.html") }}}">Demos</a>
         <a class="drop-down-item" href="{{{ relativize (versioned "home" page "tutorials/index.html") }}}">Tutorials</a>
+        <a class="drop-down-item" href="{{{ relativize (versioned "home" page "reference/index.html") }}}">CRD Reference</a>
         <a class="drop-down-item" href="{{{ relativize (versioned "home" page "release-notes.html") }}}">Release Notes</a>
     </div>
 </div>
-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]
     ++++
     </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].