lfrancke · Oct 3, 2026
diff --git a/docs/modules/zookeeper/pages/index.adoc b/docs/modules/zookeeper/pages/index.adoc
@@ -3,9 +3,9 @@
 :keywords: Stackable operator, Hadoop, Apache ZooKeeper, Kubernetes, k8s, operator, metadata, storage, cluster
 :zookeeper: https://zookeeper.apache.org/
 :github: https://github.com/stackabletech/zookeeper-operator/
-:crd: {crd-docs-base-url}/zookeeper-operator/{crd-docs-version}/
-:crd-zookeepercluster: {crd-docs}/zookeeper.stackable.tech/zookeepercluster/v1alpha1/
-:crd-zookeeperznode: {crd-docs}/zookeeper.stackable.tech/zookeeperznode/v1alpha1/
+:crd: {crd-ref}{crd-ref-release}&operator=zookeeper-operator
+:crd-zookeepercluster: {crd-ref}/zookeeper.stackable.tech/v1alpha1/zookeepercluster{crd-ref-release}
+:crd-zookeeperznode: {crd-ref}/zookeeper.stackable.tech/v1alpha1/zookeeperznode{crd-ref-release}
 :feature-tracker: https://features.stackable.tech/unified
 
 [.link-bar]

diff --git a/docs/modules/zookeeper/pages/reference/crds.adoc b/docs/modules/zookeeper/pages/reference/crds.adoc
@@ -1,3 +1,3 @@
 = CRD Reference
 
-Find all CRD reference for the Stackable Operator for Apache ZooKeeper at: {crd-docs-base-url}/zookeeper-operator/{crd-docs-version}.
+Find all CRD reference for the Stackable Operator for Apache ZooKeeper at: {crd-ref}{crd-ref-release}&operator=zookeeper-operator.
diff --git a/docs/modules/zookeeper/pages/usage_guide/authentication.adoc b/docs/modules/zookeeper/pages/usage_guide/authentication.adoc
@@ -30,4 +30,4 @@ and unauthenticated access to the ZooKeeper cluster is still possible.
 == Learn more
 
 * Read the xref:concepts:authentication.adoc[authentication concept] of the Stackable Data Platform.
-* Read the {crd-docs}/authentication.stackable.tech/authenticationclass/v1alpha1/[AuthenticationClass reference {external-link-icon}^].
+* Read the {crd-ref}/authentication.stackable.tech/v1alpha1/authenticationclass{crd-ref-release}[AuthenticationClass reference {external-link-icon}^].
diff --git a/docs/modules/zookeeper/pages/znodes.adoc b/docs/modules/zookeeper/pages/znodes.adoc
@@ -53,4 +53,4 @@ ZNodes however are product specific and need to be managed by product teams that
 
 == What's next
 
-Have a look at the usage guide for ZNodes: xref:usage_guide/isolating_clients_with_znodes.adoc[] or the CRD reference for the {crd-docs}/zookeeper.stackable.tech/zookeeperznode/v1alpha1/[ZookeeperZnode {external-link-icon}^] CustomResource.
+Have a look at the usage guide for ZNodes: xref:usage_guide/isolating_clients_with_znodes.adoc[] or the CRD reference for the {crd-ref}/zookeeper.stackable.tech/v1alpha1/zookeeperznode{crd-ref-release}[ZookeeperZnode {external-link-icon}^] CustomResource.
diff --git a/docs/modules/zookeeper/partials/nav.adoc b/docs/modules/zookeeper/partials/nav.adoc
@@ -21,8 +21,8 @@
 *** xref:zookeeper:usage_guide/operations/graceful-shutdown.adoc[]
 * xref:zookeeper:reference/index.adoc[]
 ** xref:zookeeper:reference/crds.adoc[]
-*** {crd-docs}/zookeeper.stackable.tech/zookeepercluster/v1alpha1/[ZookeeperCluster {external-link-icon}^]
-*** {crd-docs}/zookeeper.stackable.tech/zookeeperznode/v1alpha1/[ZookeeperZnode {external-link-icon}^]
+*** {crd-ref}/zookeeper.stackable.tech/v1alpha1/zookeepercluster{crd-ref-release}[ZookeeperCluster {external-link-icon}^]
+*** {crd-ref}/zookeeper.stackable.tech/v1alpha1/zookeeperznode{crd-ref-release}[ZookeeperZnode {external-link-icon}^]
 ** xref:zookeeper:reference/discovery.adoc[]
 ** xref:zookeeper:reference/commandline-parameters.adoc[]
 ** xref:zookeeper:reference/environment-variables.adoc[]
Original file line number	Diff line number	Diff line change
Expand Up		@@ -53,4 +53,4 @@ ZNodes however are product specific and need to be managed by product teams that

		== What's next

		Have a look at the usage guide for ZNodes: xref:usage_guide/isolating_clients_with_znodes.adoc[] or the CRD reference for the {crd-docs}/zookeeper.stackable.tech/zookeeperznode/v1alpha1/[ZookeeperZnode {external-link-icon}^] CustomResource.
		Have a look at the usage guide for ZNodes: xref:usage_guide/isolating_clients_with_znodes.adoc[] or the CRD reference for the {crd-ref}/zookeeper.stackable.tech/v1alpha1/zookeeperznode{crd-ref-release}[ZookeeperZnode {external-link-icon}^] CustomResource.