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 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'