From a04780980d18c6e65dc860498ada3f0fbcff6ef9 Mon Sep 17 00:00:00 2001 From: JakeSCahill Date: Thu, 16 Jul 2026 16:42:04 +0100 Subject: [PATCH 1/2] docs: shadow linking troubleshooting only requires the flag on the shadow cluster The prerequisites already state that only the shadow cluster needs enable_shadow_linking, but the troubleshooting section told users to verify it on both clusters. LLM assistants latch onto this as a debugging gotcha even when irrelevant (DOC-2231). --- .../pages/kubernetes/shadowing/k-shadow-linking.adoc | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/modules/manage/pages/kubernetes/shadowing/k-shadow-linking.adoc b/modules/manage/pages/kubernetes/shadowing/k-shadow-linking.adoc index 589d5e8fe0..0c56b485b0 100644 --- a/modules/manage/pages/kubernetes/shadowing/k-shadow-linking.adoc +++ b/modules/manage/pages/kubernetes/shadowing/k-shadow-linking.adoc @@ -800,17 +800,16 @@ kubectl describe shadowlink --namespace Helm:: + -- -Verify shadow linking is enabled on both clusters: +Verify shadow linking is enabled on the shadow cluster: [,bash] ---- -kubectl exec --namespace --container redpanda -- \ - rpk cluster config get enable_shadow_linking - kubectl exec --namespace --container redpanda -- \ rpk cluster config get enable_shadow_linking ---- +Only the shadow (target) cluster requires the `enable_shadow_linking` property. The source cluster does not require it, unless that cluster also acts as the shadow cluster of another shadow link, such as in bi-directional topologies. + Check shadow link status for errors: [,bash] From d7dca3eb5ced61fa1a7934475aa00893c48de197 Mon Sep 17 00:00:00 2001 From: JakeSCahill Date: Tue, 28 Jul 2026 16:30:08 +0100 Subject: [PATCH 2/2] docs: use bidirectional to match established spelling --- modules/manage/pages/kubernetes/shadowing/k-shadow-linking.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/manage/pages/kubernetes/shadowing/k-shadow-linking.adoc b/modules/manage/pages/kubernetes/shadowing/k-shadow-linking.adoc index 0c56b485b0..0c3fb15cd8 100644 --- a/modules/manage/pages/kubernetes/shadowing/k-shadow-linking.adoc +++ b/modules/manage/pages/kubernetes/shadowing/k-shadow-linking.adoc @@ -808,7 +808,7 @@ kubectl exec --namespace --container redpan rpk cluster config get enable_shadow_linking ---- -Only the shadow (target) cluster requires the `enable_shadow_linking` property. The source cluster does not require it, unless that cluster also acts as the shadow cluster of another shadow link, such as in bi-directional topologies. +Only the shadow (target) cluster requires the `enable_shadow_linking` property. The source cluster does not require it, unless that cluster also acts as the shadow cluster of another shadow link, such as in bidirectional topologies. Check shadow link status for errors: