fix(home): guard ADP home links on site-adp-enabled (stop agentic-data-plane xref errors in non-ADP builds)

.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

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'

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"

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
 

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
     # ===========================================================================

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'