From 049d40c0346a87991104bf772639e664735fb3e6 Mon Sep 17 00:00:00 2001 From: micheleRP Date: Sun, 17 May 2026 20:29:10 -0600 Subject: [PATCH 1/3] Hide self-managed release notes prerequisite from cloud build The xref to get-started:release-notes/redpanda.adoc inside the single-sourced Schema Registry contexts page broke the cloud-docs build (the target page only exists in the self-managed component). The "Redpanda v26.1 or later" prerequisite also doesn't apply to cloud users since Redpanda Cloud manages versions for them. Wrap the bullet in ifndef::env-cloud[] so it appears only in the self-managed build. Co-Authored-By: Claude Opus 4.7 (1M context) --- modules/manage/pages/schema-reg/schema-reg-contexts.adoc | 2 ++ 1 file changed, 2 insertions(+) diff --git a/modules/manage/pages/schema-reg/schema-reg-contexts.adoc b/modules/manage/pages/schema-reg/schema-reg-contexts.adoc index bccfdb82e0..e8655efd88 100644 --- a/modules/manage/pages/schema-reg/schema-reg-contexts.adoc +++ b/modules/manage/pages/schema-reg/schema-reg-contexts.adoc @@ -62,7 +62,9 @@ endif::env-cloud[] Before using Schema Registry contexts, ensure that: +ifndef::env-cloud[] * You are running xref:get-started:release-notes/redpanda.adoc[Redpanda v26.1] or later. +endif::[] * The xref:reference:properties/cluster-properties.adoc#schema_registry_enable_qualified_subjects[`schema_registry_enable_qualified_subjects`] cluster configuration property is set to `true`. + [IMPORTANT] From c71c7a84862d6f3fd9619ec2cca3a66ea1f6e001 Mon Sep 17 00:00:00 2001 From: micheleRP Date: Mon, 18 May 2026 11:17:21 -0600 Subject: [PATCH 2/3] Address review: fix related_topics xref and endif consistency Two follow-ups from PR review: - Line 67: use the named `endif::env-cloud[]` form to match the rest of the file. - Lines 781-786: collapse the related_topics conditional that pointed to a non-existent `reference:cluster-properties.adoc` (short path) in the self-managed branch. Both repos only have the long path at `reference:properties/cluster-properties.adoc`, so the conditional is dead weight and produced a broken xref on the live self-managed page. Co-Authored-By: Claude Opus 4.7 (1M context) --- modules/manage/pages/schema-reg/schema-reg-contexts.adoc | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/modules/manage/pages/schema-reg/schema-reg-contexts.adoc b/modules/manage/pages/schema-reg/schema-reg-contexts.adoc index e8655efd88..3d07534a90 100644 --- a/modules/manage/pages/schema-reg/schema-reg-contexts.adoc +++ b/modules/manage/pages/schema-reg/schema-reg-contexts.adoc @@ -64,7 +64,7 @@ Before using Schema Registry contexts, ensure that: ifndef::env-cloud[] * You are running xref:get-started:release-notes/redpanda.adoc[Redpanda v26.1] or later. -endif::[] +endif::env-cloud[] * The xref:reference:properties/cluster-properties.adoc#schema_registry_enable_qualified_subjects[`schema_registry_enable_qualified_subjects`] cluster configuration property is set to `true`. + [IMPORTANT] @@ -778,10 +778,5 @@ curl -s -X DELETE http://localhost:8081/contexts/.staging * xref:manage:schema-reg/schema-reg-authorization.adoc[] * link:/api/doc/schema-registry/[Schema Registry API reference] * xref:reference:public-metrics-reference.adoc[] -ifndef::env-cloud[] -* xref:reference:cluster-properties.adoc[] -endif::env-cloud[] -ifdef::env-cloud[] * xref:reference:properties/cluster-properties.adoc[] -endif::env-cloud[] // end::single-source[] From 09e0ba23c2ecbd584aebcf8ca544b1ed8831d499 Mon Sep 17 00:00:00 2001 From: micheleRP Date: Mon, 18 May 2026 11:21:51 -0600 Subject: [PATCH 3/3] Match other ifndef instances: blank line after endif Co-Authored-By: Claude Opus 4.7 (1M context) --- modules/manage/pages/schema-reg/schema-reg-contexts.adoc | 1 + 1 file changed, 1 insertion(+) diff --git a/modules/manage/pages/schema-reg/schema-reg-contexts.adoc b/modules/manage/pages/schema-reg/schema-reg-contexts.adoc index 3d07534a90..4afbee4ea3 100644 --- a/modules/manage/pages/schema-reg/schema-reg-contexts.adoc +++ b/modules/manage/pages/schema-reg/schema-reg-contexts.adoc @@ -65,6 +65,7 @@ Before using Schema Registry contexts, ensure that: ifndef::env-cloud[] * You are running xref:get-started:release-notes/redpanda.adoc[Redpanda v26.1] or later. endif::env-cloud[] + * The xref:reference:properties/cluster-properties.adoc#schema_registry_enable_qualified_subjects[`schema_registry_enable_qualified_subjects`] cluster configuration property is set to `true`. + [IMPORTANT]