Docs site restructure to support ADP and Data Platform users

INTERIM-HOME-PAGE.md

@@ -0,0 +1,83 @@
+# Interim Home Page Configuration
+
+**Status**: TEMPORARY - Data Platform is currently the home page instead of the dedicated home component.
+
+## Current Configuration
+
+The following changes were made to use data-platform as the home page:
+
+### 1. Playbook Changes (`test-unified-nav.yml`)
+```yaml
+site:
+  start_page: data-platform::index.adoc  # Changed from home::index.adoc
+
+content:
+  sources:
+  - url: .
+    branches: HEAD
+    start_paths: [data-platform, self-managed]  # Removed 'home'
+```
+
+### 2. Redirect (`netlify.toml`)
+```toml
+[[redirects]]
+from = "/home"
+to = "/data-platform/"  # Changed from "/current/home"
+status = 301
+```
+
+## Features Added to Data Platform
+
+The data-platform page now includes:
+
+1. **Ask AI Search Input** - Hero section with AI search input and suggestion chips
+2. **NEW Badge for SQL** - Cloud BYOC stat shows "+ SQL" with NEW badge when SQL docs have `page-new` attribute
+3. **Improved Hero** - More prominent call-to-action for AI assistance
+
+## How to Revert to Original Home Page
+
+When ready to restore the dedicated home component, make these changes:
+
+### Step 1: Update Playbook
+**File**: `test-unified-nav.yml` (or your production playbook)
+
+```yaml
+site:
+  start_page: home::index.adoc  # Change back to home
+
+content:
+  sources:
+  - url: .
+    branches: HEAD
+    start_paths: [home, data-platform, self-managed]  # Add 'home' back
+```
+
+### Step 2: Restore Redirect
+**File**: `netlify.toml`
+
+```toml
+[[redirects]]
+from = "/home"
+to = "/current/home"  # Change back to home
+status = 301
+```
+
+### Step 3: Rebuild
+```bash
+npx antora your-playbook.yml
+```
+
+## Why This Change?
+
+Without the Agentic Data Plane component launched, the dedicated home page felt sparse. The data-platform page provides a better entry point showcasing:
+- Cloud and Self-Managed options
+- Ask AI search for immediate help
+- Clear path to documentation
+- NEW badge highlighting Cloud BYOC SQL feature
+
+## When to Revert?
+
+Revert when:
+1. Agentic Data Plane launches and needs prominent placement
+2. Home page gets redesigned with better content
+3. Marketing/product decides original structure is better

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.10/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: 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,87 @@
+= 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
+// === ASK AI SECTION ===
+:hero-ask-placeholder: Ask AI about Redpanda...
+:hero-suggestions-label: Try asking:
+:hero-suggestion-1: How do I write from Redpanda Streaming to Snowflake?
+:hero-suggestion-2: What's the difference between Redpanda and Kafka?
+:hero-suggestion-3: How do I create a CDC pipeline from Postgres to Redpanda Cloud?
+// === 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
+// === 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 Redpanda 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
+// === CORE CONCEPTS ===
+:page-concepts-heading: Core concepts
+: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.
+// === WHAT'S NEW SECTION ===
+:page-whats-new-1-title: Redpanda SQL
+:page-whats-new-1-desc: Query your streaming data in real-time with SQL. Run analytical queries directly on topics without ETL (BYOC clusters only).
+:page-whats-new-1-link: cloud-data-platform:sql:index.adoc
+:page-whats-new-1-tag: Cloud BYOC
+// === 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-producers: streaming:develop:produce-data/configure-producers.adoc
+:page-self-managed-consumers: streaming:develop:consume-data/consumer-offsets.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
+:page-cloud-sql-docs: cloud-data-platform:sql:index.adoc
+// Connect links
+:page-connect-quickstart: connect:get-started:quickstarts/index.adoc

home/antora.yml

@@ -1,12 +1,32 @@
 name: home
 title: Home
 version: ~
-start_page: ROOT:index.adoc
+start_page: index.adoc
+nav:
+- modules/ROOT/nav.adoc
 asciidoc:
   attributes:
+    # Component metadata for navigation system
+    component-metadata:
+      title: "Home"
+      description: "Redpanda Documentation"
+      color: "#6366f1"
+      icon: "home"
+      order: 0
+    # 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:
+      - home:
+          - 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 +41,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/nav.adoc

@@ -0,0 +1,2 @@
+* xref:index.adoc[Overview]
+* xref:mcp-setup.adoc[Install the Docs MCP Server]