Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
25 commits
Select commit Hold shift + click to select a range
5890c0e
Add adp-docs as content source for ADP documentation
JakeSCahill Apr 22, 2026
510dc60
Add ADP homepage card and icon
JakeSCahill Apr 23, 2026
27614c9
chore: Reference cloud-docs feature branch for ADP cleanup
JakeSCahill Apr 24, 2026
a6b6ea8
fix: Correct cloud-docs branch name to feature/remove-ai-agents
JakeSCahill Apr 24, 2026
50b4378
chore: Trigger rebuild after cloud-docs fix
JakeSCahill Apr 24, 2026
83e8444
Align all playbooks to use cloud-docs feature branch
JakeSCahill Apr 24, 2026
72f0391
Add page attributes for home page product card links
JakeSCahill May 7, 2026
9b5e001
Merge branch 'main' into feature/add-adp-docs
JakeSCahill Jun 5, 2026
f7eeb20
Fix: Use commit-aware Netlify deploy action to prevent stale cache te…
JakeSCahill Jun 5, 2026
b7f033b
Move 'How to Use These Docs' to home component and add ADP
JakeSCahill Jun 5, 2026
a11b0ef
Update preview-antora-playbook.yml
JakeSCahill Jun 5, 2026
c67525e
Update antora-playbook.yml
JakeSCahill Jun 5, 2026
12b9b8b
Update nav.adoc
JakeSCahill Jun 5, 2026
067881f
Remove Try asking suggestions from Data Platform hero
JakeSCahill Jun 9, 2026
8ffbedd
Fix redirects
JakeSCahill Jun 11, 2026
3b17251
Use local adp-docs worktree in local-antora-playbook.yml
JakeSCahill Jun 11, 2026
382a26a
Use local streaming docs worktree in local-antora-playbook.yml
JakeSCahill Jun 11, 2026
641c79e
Fix duplicate page attributes and update local playbook
JakeSCahill Jun 12, 2026
5873a19
Revert to jakepartusch/wait-for-netlify-action@v1.4
JakeSCahill Jun 12, 2026
f84b8ca
Update antora.yml
JakeSCahill Jun 15, 2026
fc48842
fix: update llms.adoc AI agents links to correct agentic-data-plane p…
JakeSCahill Jun 15, 2026
5d10468
fix: correct MCP server link to home/how-to-use-these-docs.md
JakeSCahill Jun 15, 2026
c1f1f2c
Update playbooks for release
JakeSCahill Jun 15, 2026
aee67b9
Remove redirect tests and documentation
JakeSCahill Jun 15, 2026
173291f
Add redirects for high-volume 404s after docs restructure
JakeSCahill Jun 15, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 0 additions & 39 deletions .github/workflows/afdocs-checks.yml
Original file line number Diff line number Diff line change
Expand Up @@ -51,42 +51,3 @@ jobs:
echo "**Deploy URL:** ${{ steps.wait-for-netlify.outputs.url }}" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
echo "Run locally: \`DEPLOY_URL=${{ steps.wait-for-netlify.outputs.url }} npm run afdocs:verbose\`" >> $GITHUB_STEP_SUMMARY

redirect-tests:
name: Redirect Tests
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4

- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: '24'
cache: 'npm'

- name: Install dependencies
run: npm ci

- name: Wait for Netlify Deploy
uses: jakepartusch/wait-for-netlify-action@v1.4
id: wait-for-netlify
with:
site_name: redpanda-documentation
max_timeout: 600

- name: Run redirect tests
env:
DEPLOY_URL: ${{ steps.wait-for-netlify.outputs.url }}
run: npm run test:redirects:verbose

- name: Post results summary
if: always()
run: |
echo "## Redirect Tests" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
echo "**Deploy URL:** ${{ steps.wait-for-netlify.outputs.url }}" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
echo "Validates redirect rules in netlify.toml" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
echo "Run locally: \`DEPLOY_URL=${{ steps.wait-for-netlify.outputs.url }} npm run test:redirects:verbose\`" >> $GITHUB_STEP_SUMMARY
196 changes: 0 additions & 196 deletions REDIRECT_TESTING.md

This file was deleted.

2 changes: 2 additions & 0 deletions antora-playbook.yml
Original file line number Diff line number Diff line change
Expand Up @@ -81,6 +81,8 @@ content:
branches: main
- url: https://github.com/redpanda-data/rp-connect-docs
branches: main
- url: https://github.com/redpanda-data/adp-docs
branches: main
ui:
bundle:
url: https://github.com/redpanda-data/docs-ui/releases/latest/download/ui-bundle.zip
Expand Down
1 change: 0 additions & 1 deletion data-platform/modules/ROOT/nav.adoc
Original file line number Diff line number Diff line change
@@ -1,2 +1 @@
* xref:index.adoc[Overview]
* xref:how-to-use-these-docs.adoc[How to Use These Docs]
4 changes: 0 additions & 4 deletions data-platform/modules/ROOT/pages/index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -11,10 +11,6 @@
: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.
Expand Down
5 changes: 5 additions & 0 deletions home/antora.yml
Original file line number Diff line number Diff line change
Expand Up @@ -57,3 +57,8 @@ asciidoc:
description: 'Integrate data across systems with hundreds of prebuilt connectors, including AI and change data capture (CDC).'
urls:
- url: 'connect:get-started:quickstarts/rpk.adoc'
- title: 'Agentic Data Plane'
image: adp.svg
description: 'Build, deploy, and govern AI agents at scale with enterprise governance, cost controls, and compliance-grade audit trails.'
urls:
- url: 'agentic-data-plane:home:index.adoc'
5 changes: 5 additions & 0 deletions home/modules/ROOT/images/adp.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion home/modules/ROOT/nav.adoc
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
* xref:index.adoc[Overview]
* xref:data-platform:ROOT:how-to-use-these-docs.adoc[How to Use These Docs]
* xref:ROOT:how-to-use-these-docs.adoc[How to Use These Docs]
Original file line number Diff line number Diff line change
@@ -1,41 +1,41 @@
= How to Use These Docs
:description: Navigate Redpanda's documentation structure and leverage AI-powered features including MCP server integration, markdown exports, and interactive documentation tools.
:page-aliases: mcp-setup.adoc, home:ROOT:mcp-setup.adoc
:page-aliases: home:ROOT:mcp-setup.adoc, data-platform:ROOT:how-to-use-these-docs.adoc

Redpanda's documentation helps you stream data, build pipelines, and deploy AI agents whether you manage infrastructure yourself or run in the cloud. This page explains how our docs are organized, clarifies the relationship between deployment models and products, and shows you how to access documentation through AI-powered tools and programmatic interfaces.

== Understand the documentation structure

Redpanda's documentation is organized around the Data Platform, the streaming foundation for everything you build. You can deploy the Data Platform in two ways: as a fully managed Cloud service or as a Self-Managed installation where you control the infrastructure. Regardless of deployment model, you have access to multiple products including Streaming (the broker and Redpanda CLI) and Connect (data pipelines).
Redpanda's documentation is organized around multiple deployment models and products. The Data Platform provides the streaming foundation with Cloud or Self-Managed deployment options. The Agentic Data Plane (ADP) offers a specialized infrastructure for AI agents and agentic workflows.

.Documentation hierarchy
----
Redpanda Documentation
└── Data Platform
├── Cloud (managed by Redpanda)
│ ├── Serverless
│ ├── BYOC
│ └── Dedicated
└── Self-Managed (managed by you)
├── Streaming (broker, Redpanda CLI)
└── Connect (data pipelines)
├── Data Platform
│ ├── Cloud (managed by Redpanda)
│ │ ├── Serverless
│ │ ├── BYOC
│ │ └── Dedicated
│ └── Self-Managed (managed by you)
│ ├── Streaming (broker, Redpanda CLI)
│ └── Connect (data pipelines)
└── Agentic Data Plane (ADP)
└── AI agent infrastructure and workflows
----

[NOTE]
====
*What changed:* Previously, the software that deployed a Redpanda broker was called "Redpanda Self-Managed". In the new structure, "Self-Managed" refers to the deployment model (you manage the infrastructure), while "Streaming" is the product name for the broker itself.

* *Old:* "Redpanda Self-Managed" is the broker product
* *New:* "Self-Managed" is deployment model that includes Streaming and Connect products
====

*Key components:*

* xref:index.adoc[Data Platform overview]: The streaming foundation
* xref:self-managed:ROOT:index.adoc[Self-Managed documentation]: Deploy and manage yourself
** 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
** xref:self-managed:ROOT:index.adoc[Self-Managed documentation]: Deploy and manage yourself
*** 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
* xref:agentic-data-plane:home:index.adoc[Agentic Data Plane (ADP)]: AI agent infrastructure

== Choose your path

Expand All @@ -58,6 +58,11 @@ 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]

*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]

== AI agent access

Redpanda's documentation is optimized for AI agents and LLM consumption. Whether you're building AI agents, IDE plugins, or automation tools, you can access documentation through interactive page features, a Model Context Protocol (MCP) server for real-time queries, and static markdown exports for offline processing.
Expand Down
Loading
Loading