Add unified navigation test playbook and umbrella components

antora-playbook.yml

@@ -68,21 +68,45 @@ runtime:
   fetch: true
 content:
   sources:
+  # docs-site components (local - umbrella components with WIP content)
   - url: .
     branches: HEAD
-    start_paths: [home]
+    start_paths: [home, data-platform, self-managed]
+
+  # docs repository - WIP feature branches for testing
+  - url: https://github.com/redpanda-data/docs
+    branches: [feature/rename-streaming-main, shared]
+
+  # docs repository - version branches for multi-version nav
   - url: https://github.com/redpanda-data/docs
-    branches: [main, v/*, shared, 'site-search', '!v-end-of-life/*']
+    branches: [
+      feature/rename-streaming-23.3,
+      feature/rename-streaming-24.1,
+      feature/rename-streaming-24.2,
+      feature/rename-streaming-24.3,
+      feature/rename-streaming-25.1,
+      feature/rename-streaming-25.2,
+      feature/rename-streaming-25.3
+    ]
+
   - url: https://github.com/redpanda-data/redpanda-labs
     branches: main
     start_paths: [docs,'*/docs']
+
+  # cloud-docs - WIP feature branch
   - url: https://github.com/redpanda-data/cloud-docs
-    branches: main
+    branches: feature/component-home-v3
+
+  # rp-connect-docs - WIP feature branch
   - url: https://github.com/redpanda-data/rp-connect-docs
-    branches: main
+    branches: feature/unified-navigation
+
+  # adp-docs - WIP feature branch
+  - url: https://github.com/redpanda-data/adp-docs
+    branches: feature/platform-badges
 ui:
   bundle:
-    url: https://github.com/redpanda-data/docs-ui/releases/latest/download/ui-bundle.zip
+    url: https://github.com/redpanda-data/docs-ui/releases/download/v3.0.0-beta.2/ui-bundle.zip
     snapshot: true
 asciidoc:
   attributes:
@@ -300,7 +324,7 @@ asciidoc:
     # ---------------------------------------------------------------------------
     # These apply to all pages in a component version:
     #
-    # - page-header-data: Header customization object with color field
+    # - component-metadata: Header customization object with color field
     # - (All announcement-*, toc-tools-* attributes also work at component level)
 
     # ---------------------------------------------------------------------------
@@ -323,6 +347,11 @@ asciidoc:
   - '@redpanda-data/docs-extensions-and-macros/asciidoc-extensions/add-line-numbers-highlights'
 antora:
   extensions:
+  # Unified navigation extension (config-driven)
+  # Components with page-navigation attribute use that config
+  # Components without page-navigation use standard Antora navigation
+  - require: '@redpanda-data/docs-extensions-and-macros/extensions/unified-navigation'
+
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/git-full-clone'
     # Configuration:
     # unshallowTimeout: 120000  # Timeout in ms (default: 60000). Increase for very large repos
@@ -337,7 +366,7 @@ antora:
     data:
       sets:
         docker_labs:
-          component: redpanda-labs
+          component: labs
           filter: docker-compose
           env_type: Docker
           attribute_name: docker-labs-index
@@ -349,18 +378,19 @@ antora:
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/archive-attachments'
     data:
       archives:
-        - component: 'ROOT'
+        - component: 'streaming'
           output_archive: 'redpanda-quickstart.tar.gz'
           file_patterns:
             - '**/test-resources/**/docker-compose/**'
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/compute-end-of-life'
     data:
       eol_settings:
-        - component: 'ROOT'
+        - component: 'streaming'
           supported_months: 12
           warning_weeks: 13
           eol_doc: https://support.redpanda.com/hc/en-us/articles/20617574366743-Redpanda-Supported-Versions
-          upgrade_doc: ROOT:upgrade:index.adoc
+          upgrade_doc: streaming:upgrade:index.adoc
+          whats_new_doc: streaming@current:get-started:release-notes/redpanda.adoc
   - require: '@sntke/antora-mermaid-extension'
     mermaid_library_url: https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjs
     script_stem: mermaid-scripts
@@ -378,8 +408,8 @@ antora:
     data:
       replacements:
         - components:
-            - 'ROOT'
-            - 'redpanda-labs'
+            - 'streaming'
+            - 'labs'
           file_patterns:
             - '**/docker-compose.yaml'
             - '**/docker-compose.yml'

data-platform/antora.yml

@@ -0,0 +1,19 @@
+name: data-platform
+title: Data Platform
+version: ~
+start_page: index.adoc
+nav:
+  - modules/ROOT/nav.adoc
+asciidoc:
+  attributes:
+    component-metadata:
+      title: "Data Platform"
+      description: "The streaming foundation for everything you build"
+      color: "#4338ca"
+      icon: "stack-2"
+    # Navigation hierarchy configuration (config-driven navigation)
+    page-navigation:
+      - cloud-data-platform
+      - self-managed:
+          - streaming
+          - connect

data-platform/modules/ROOT/nav.adoc

@@ -0,0 +1 @@
+* xref:index.adoc[Overview]

data-platform/modules/ROOT/pages/index.adoc

@@ -0,0 +1,89 @@
+= Data Platform
+:page-layout: data-platform
+:!showtitle:
+// === HERO SECTION ===
+:page-hero-eyebrow: REDPANDA DATA PLATFORM
+:page-hero-title: pass:[The streaming foundation<br>for everything you build.]
+:page-hero-subtitle: Run Redpanda on your infrastructure or let us manage it in the cloud. Then connect it to everything else with declarative pipelines.
+:page-hero-stat1-number: 10x
+:page-hero-stat1-text: faster than Kafka, same wire
+:page-hero-stat2-number: 200+
+:page-hero-stat2-text: connectors
+// === CHOOSE SECTION (heading) ===
+:page-choose-heading: Choose how you'll run Redpanda
+:page-choose-subtitle: Self-Managed or Cloud: same Kafka-compatible engine, different operations model. Both include Redpanda Connect for building data pipelines.
+// === SELF-MANAGED CARD ===
+:page-selfmanaged-title: Self-Managed
+:page-selfmanaged-tagline: Run Redpanda on your own infrastructure.
+:page-selfmanaged-description: Bare metal, VMs, or Kubernetes. Full control over networking, storage, and upgrades: with the same single binary used in Cloud.
+:page-selfmanaged-bullet1: Single binary, no JVM
+:page-selfmanaged-bullet2: Air-gapped & FedRAMP-ready
+:page-selfmanaged-bullet3: Tune every knob
+:page-selfmanaged-stat1-label: K8s
+:page-selfmanaged-stat1-value: Operator + Helm
+:page-selfmanaged-cta: Open Self-Managed docs
+// === CLOUD CARD ===
+:page-cloud-title: Cloud
+:page-cloud-tagline: Streaming, fully managed.
+:page-cloud-description: Spin up a cluster in minutes. We handle upgrades, scaling, and failover: you bring the data. Available as Dedicated, Serverless, or Bring Your Own Cloud.
+:page-cloud-bullet1: Provisioned in 90 seconds
+:page-cloud-bullet2: AWS, GCP, Azure
+:page-cloud-bullet3: 24/7 SRE on call
+:page-cloud-stat1-number: 99.99%
+:page-cloud-stat1-text: SLA on Dedicated
+:page-cloud-stat2-label: BYOC
+:page-cloud-stat2-text: Run in your VPC
+:page-cloud-cta: Open Cloud docs
+// === DECISION MATRIX ===
+:page-decision-heading: Not sure which to pick?
+:page-decision-subtitle: A quick decision matrix: most teams start with one of these two options.
+:page-decision-if1: need full control over networking, storage, and security posture
+:page-decision-then1: Start with Self-Managed
+:page-decision-if2: want streaming as a service with an SLA and zero ops
+:page-decision-then2: Start with Cloud
+// === POPULAR GUIDES ===
+:page-popular-heading: Popular across Data Platform
+:page-popular-subtitle: The guides teams open most when they're getting started.
+:page-popular-1-title: Deploy a Kafka-compatible cluster
+:page-popular-1-tag: Self-Managed
+:page-popular-2-title: Tiered storage on S3
+:page-popular-2-tag: Self-Managed
+:page-popular-3-title: Create your first BYOC cluster
+:page-popular-3-tag: Cloud
+:page-popular-4-title: Connect Postgres CDC to Snowflake
+:page-popular-4-tag: Connect
+:page-popular-5-title: Migrate from Apache Kafka
+:page-popular-5-tag: All
+:page-popular-6-title: Schema Registry & validation
+:page-popular-6-tag: All
+// === CORE CONCEPTS ===
+:page-concepts-heading: Core concepts
+:page-concepts-subtitle: The mental model that applies everywhere: Self-Managed, Cloud, and Connect.
+:page-concept-1-title: Topics & partitions
+:page-concept-1-description: How Redpanda lays out data on disk and parallelizes reads.
+:page-concept-2-title: Tiered storage
+:page-concept-2-description: Offload cold segments to S3-compatible storage automatically.
+:page-concept-3-title: Consumer groups
+:page-concept-3-description: Coordinated, fault-tolerant consumption across many workers.
+:page-concept-4-title: Schemas & contracts
+:page-concept-4-description: Validate every message at the broker with Avro, Protobuf, or JSON Schema.
+// === HELP FOOTER ===
+:page-help-heading: Need help choosing?
+:page-help-subtitle: Our team can walk you through the options and help you get started.
+:page-help-btn1-text: Talk to sales
+:page-help-btn1-url: https://redpanda.com/contact
+:page-help-btn2-text: Join Slack
+:page-help-btn2-url: https://redpanda.com/slack
+// Self-Managed links
+:page-self-managed-home: streaming:home:index.adoc
+:page-self-managed-quickstart: streaming:get-started:quick-start.adoc
+:page-self-managed-tiered-storage: streaming:manage:tiered-storage.adoc
+:page-self-managed-migrate: streaming:migrate:index.adoc
+:page-self-managed-producers: streaming:develop:produce-data/configure-producers.adoc
+:page-self-managed-consumers: streaming:develop:consume-data/consumer-offsets.adoc
+:page-self-managed-schema-registry: streaming:manage:schema-reg/index.adoc
+// Cloud links
+:page-cloud-home: cloud-data-platform:home:index.adoc
+:page-cloud-byoc: cloud-data-platform:get-started:cluster-types/byoc/index.adoc
+// Connect links
+:page-connect-quickstart: connect:get-started:quickstarts/index.adoc

home/antora.yml

@@ -1,12 +1,22 @@
 name: home
 title: Home
 version: ~
-start_page: ROOT:index.adoc
+start_page: index.adoc
 asciidoc:
   attributes:
+    # Components to show in the home page navigation sidebar
+    page-nav-components: 'agentic-data-plane,data-platform'
+    # Navigation hierarchy configuration (config-driven navigation)
+    page-navigation:
+      - agentic-data-plane
+      - data-platform:
+          - cloud-data-platform
+          - self-managed:
+              - streaming
+              - connect
     # Data for the home page
     page-ai-suggestions:
-      - "How do I write from Redpanda Self-Managed to Snowflake?"
+      - "How do I write from Redpanda Streaming to Snowflake?"
       - "What's the difference between Redpanda and Kafka?"
       - "Which Iceberg catalogs does Redpanda Cloud support?"
       - "How do I create a CDC pipeline from MongoDB to Redpanda Cloud?"
@@ -21,19 +31,19 @@ asciidoc:
             image: serverless.svg
             description: 'Get fast, efficient, and scalable data streaming without infrastructure management.'
             urls:
-              - url: 'redpanda-cloud:get-started:cluster-types/serverless.adoc'
+              - url: 'cloud-data-platform:get-started:cluster-types/serverless.adoc'
           - title: 'BYOC'
             image: byoc.svg
             description: 'Run fully managed Redpanda clusters in your own cloud (AWS, Azure, or GCP) for additional security and data isolation.'
             urls:
-              - url: 'redpanda-cloud:get-started:cluster-types/byoc/index.adoc'
+              - url: 'cloud-data-platform:get-started:cluster-types/byoc/index.adoc'
           - title: 'Self-Managed'
             image: self-managed.svg
             description: 'Run Redpanda on your own infrastructure with complete control over your deployment and configuration.'
             urls:
-              - url: 'ROOT:get-started:quick-start.adoc'
+              - url: 'streaming:get-started:quick-start.adoc'
           - title: 'Connect'
             image: connect.svg
             description: 'Integrate data across systems with hundreds of prebuilt connectors, including AI and change data capture (CDC).'
             urls:
-              - url: 'redpanda-connect:get-started:quickstarts/rpk.adoc'
+              - url: 'connect:get-started:quickstarts/rpk.adoc'

home/modules/ROOT/pages/index.adoc

@@ -1,6 +1,51 @@
 = Welcome to Redpanda Documentation
 :page-role: home
+:page-expand-buckets: agentic-data-plane
 :description: Redpanda is a high-performance streaming data platform and Agentic Data Plane. Kafka API-compatible, it enables real-time data streaming, event-driven architectures, and AI agent governance and observability.
+// Hero section content
+:page-hero-eyebrow: Redpanda Documentation
+:page-hero-title: pass:[Everything you need to move data<br>and put agents to work on&nbsp;it.]
+:page-hero-subtitle: pass:[Guides, concepts, and references for the two platforms that power Redpanda: streaming your data reliably and letting AI agents act on it safely.]
+:page-hero-ask-placeholder: pass:[Ask Redpanda AI a question"]
+:page-hero-suggestions-label: Try:
+:page-hero-suggestion-1: How do I connect Salesforce as an MCP source?
+:page-hero-suggestion-2: Set a monthly token budget
+:page-hero-suggestion-3: Deploy Redpanda on Kubernetes
+// Intent cards content
+:page-intent-heading: What are you here for
+:page-intent-dp-title: Stream and process data
+:page-intent-dp-desc: Run Redpanda clusters, move data reliably between systems, and keep storage lean with Tiered Storage and connectors.
+:page-intent-dp-tags: Cloud · Self-Managed
+:page-intent-dp-cta: Get started with Data Platform
+:page-intent-adp-title: Build agentic data flows
+:page-intent-adp-desc: Build, connect, and govern AI agents on top of your data. Create agents without code, plug in Salesforce or your database, and keep every action observable and in-policy.
+:page-intent-adp-tags: Agentic Data Plane
+:page-intent-adp-cta: Get started with ADP
+// Products section content
+:page-products-heading: Or jump straight to a product
+:page-products-dp-heading: Data Platform
+:page-products-adp-heading: Agentic Data Plane
+:page-product-cloud-title: Cloud
+:page-product-cloud-desc: Streaming, Connect, and SQL with Serverless or BYOC deployment
+:page-product-self-managed-title: Self-Managed
+:page-product-self-managed-desc: Deploy on your infrastructure
+:page-product-streaming-title: Streaming
+:page-product-streaming-desc: Redpanda broker and rpk CLI
+:page-product-connect-title: Connect
+:page-product-connect-desc: Data pipelines and transformations
+:page-product-adp-title: Agentic Data Plane
+:page-product-adp-desc: Multi-agent infrastructure
+:page-product-link-get-started: Get started
+:page-product-link-docs: Docs
+// Product quick links
+:page-cloud-quickstart: cloud-data-platform:get-started:index.adoc
+:page-cloud-docs: cloud-data-platform:ROOT:index.adoc
+:page-self-managed-quickstart: streaming:get-started:quick-start.adoc
+:page-self-managed-docs: self-managed:ROOT:index.adoc
+:page-connect-quickstart: connect:get-started:quickstarts/rpk.adoc
+:page-connect-docs: connect:home:index.adoc
+:page-adp-quickstart: agentic-data-plane:get-started:byoc-quickstart.adoc
+:page-adp-docs: agentic-data-plane:ROOT:index.adoc
 :page-faq-1-question: What is Redpanda?
 :page-faq-1-answer: Redpanda is a streaming data platform and Agentic Data Plane for developers. It's Kafka API-compatible but simpler to deploy and operate, designed for modern applications and AI agents requiring real-time data processing without the operational complexity of traditional platforms.
 :page-faq-2-question: How do I get started with Redpanda?