From e158d6dbb31e67ca9863d9cf4b7f6844c9219265 Mon Sep 17 00:00:00 2001 From: Joyce Fee Date: Thu, 25 Jun 2026 10:46:18 -0400 Subject: [PATCH 1/2] fix(home): guard ADP home links on site-adp-enabled so non-ADP builds don't error MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The shared home page (how-to-use-these-docs.adoc) links to xref:agentic-data-plane:home:index.adoc unconditionally. Every build that aggregates docs-site/home but NOT the adp-docs component — the 25.x docs branches and the per-repo previews (docs main, cloud-docs, rp-connect-docs) — logs `ERROR (asciidoctor): target of xref not found: agentic-data-plane:...`. The gating attribute `site-adp-enabled` already existed but was never honored by the page. This wires it up: - home/antora.yml: default site-adp-enabled to 'false' (component-level, always defined) so ADP-less builds hide the links instead of erroring. - how-to-use-these-docs.adoc: guard the two ADP xref blocks with `ifeval::["{site-adp-enabled}" == "true"]`. - antora-playbook.yml / preview / local: set site-adp-enabled 'true' (these aggregate adp-docs), so production and preview home still render ADP. Verified the guard toggles via asciidoctor: false/undefined -> ADP xrefs hidden, true -> shown. Co-Authored-By: Claude Opus 4.8 (1M context) --- antora-playbook.yml | 6 ++++-- home/antora.yml | 5 +++++ home/modules/ROOT/pages/how-to-use-these-docs.adoc | 4 ++++ local-antora-playbook.yml | 2 ++ preview-antora-playbook.yml | 2 ++ 5 files changed, 17 insertions(+), 2 deletions(-) diff --git a/antora-playbook.yml b/antora-playbook.yml index ff1a85fe..53541179 100644 --- a/antora-playbook.yml +++ b/antora-playbook.yml @@ -322,8 +322,10 @@ asciidoc: # site-adp-enabled: Controls whether ADP (Agentic Data Plane) content is shown # - When true: Home page shows full content with ADP options # - When false: Home page redirects to Data Platform landing - # Set this to false when building without adp-docs component - site-adp-enabled: 'false' + # Set this to false when building without adp-docs component. + # The home page guards ADP links on this attribute (ifeval site-adp-enabled == 'true'), + # so production (which aggregates adp-docs) must keep this 'true' to render ADP content. + site-adp-enabled: 'true' extensions: - '@asciidoctor/tabs' diff --git a/home/antora.yml b/home/antora.yml index 996db49e..398f0857 100644 --- a/home/antora.yml +++ b/home/antora.yml @@ -6,6 +6,11 @@ nav: - modules/ROOT/nav.adoc asciidoc: attributes: + # Whether ADP (Agentic Data Plane) content renders on the shared home page. + # Default OFF so builds that don't aggregate the adp-docs component (25.x branches, + # per-repo previews) hide ADP links instead of emitting broken-xref errors. + # Overridden to 'true' in the docs-site playbooks that aggregate adp-docs. + site-adp-enabled: 'false' # Component metadata for navigation system component-metadata: title: "Home" diff --git a/home/modules/ROOT/pages/how-to-use-these-docs.adoc b/home/modules/ROOT/pages/how-to-use-these-docs.adoc index 95def7c6..b68d9991 100644 --- a/home/modules/ROOT/pages/how-to-use-these-docs.adoc +++ b/home/modules/ROOT/pages/how-to-use-these-docs.adoc @@ -35,7 +35,9 @@ Redpanda Documentation *** xref:streaming:home:index.adoc[Streaming documentation]: Broker and Redpanda CLI *** xref:connect:home:index.adoc[Connect documentation]: Data pipelines and integration ** xref:cloud-data-platform:home:index.adoc[Cloud documentation]: Fully managed services +ifeval::["{site-adp-enabled}" == "true"] * xref:agentic-data-plane:home:index.adoc[Agentic Data Plane (ADP)]: AI agent infrastructure +endif::[] == Choose your path @@ -58,10 +60,12 @@ Find the documentation that matches your use case: * Hundreds of prebuilt connectors including AI and change data capture (CDC) * xref:connect:home:index.adoc[Connect documentation] +ifeval::["{site-adp-enabled}" == "true"] *I want to build AI agent infrastructure* → ADP docs * Specialized platform for agentic workflows and AI agent orchestration * xref:agentic-data-plane:home:index.adoc[Get started with ADP] +endif::[] == AI agent access diff --git a/local-antora-playbook.yml b/local-antora-playbook.yml index b92b42a6..4dd4f7b8 100644 --- a/local-antora-playbook.yml +++ b/local-antora-playbook.yml @@ -35,6 +35,8 @@ ui: snapshot: true asciidoc: attributes: + # ADP home content renders in this build (aggregates adp-docs). See home/antora.yml. + site-adp-enabled: 'true' # =========================================================================== # GLOBAL ASCIIDOC ATTRIBUTES # =========================================================================== diff --git a/preview-antora-playbook.yml b/preview-antora-playbook.yml index 7a0519aa..56234379 100644 --- a/preview-antora-playbook.yml +++ b/preview-antora-playbook.yml @@ -39,6 +39,8 @@ ui: snapshot: true asciidoc: attributes: + # ADP home content renders in this build (aggregates adp-docs). See home/antora.yml. + site-adp-enabled: 'true' extensions: - '@asciidoctor/tabs' - '@redpanda-data/docs-extensions-and-macros/macros/rp-connect-components' From 4e95aa3f09db6ceddd7d646b0c497acdb8daae0f Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 25 Jun 2026 15:17:31 +0000 Subject: [PATCH 2/2] ci: increase Netlify wait timeout for afdocs check --- .github/workflows/afdocs-checks.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/afdocs-checks.yml b/.github/workflows/afdocs-checks.yml index 2b87a462..99331c2f 100644 --- a/.github/workflows/afdocs-checks.yml +++ b/.github/workflows/afdocs-checks.yml @@ -35,7 +35,7 @@ jobs: id: wait-for-netlify with: site_name: redpanda-documentation - max_timeout: 600 + max_timeout: 1200 - name: Run afdocs checks continue-on-error: true