Skip to content

Add Agentic Data Plane (ADP) documentation support#170

Draft
JakeSCahill wants to merge 13 commits into
mainfrom
feature/add-adp-docs
Draft

Add Agentic Data Plane (ADP) documentation support#170
JakeSCahill wants to merge 13 commits into
mainfrom
feature/add-adp-docs

Conversation

@JakeSCahill
Copy link
Copy Markdown
Contributor

@JakeSCahill JakeSCahill commented Apr 23, 2026

Summary

Adds ADP (Agentic Data Plane) documentation support with dynamic homepage product card links.

Changes

ADP Documentation Integration

  • Add adp-docs repository as content source in all playbooks:
    • antora-playbook.yml (production)
    • local-antora-playbook.yml (local development)
    • preview-antora-playbook.yml (preview builds)
  • Add ADP homepage card with icon
  • New ADP icon: home/modules/ROOT/images/adp.svg

Dynamic Product Card Links

Adds page attributes for all product cards to enable dynamic link resolution in UI templates:

Attribute Target Page
:page-cloud-quickstart: redpanda-cloud:get-started:index.adoc
:page-cloud-docs: redpanda-cloud:home:index.adoc
:page-self-managed-quickstart: ROOT:get-started:quick-start.adoc
:page-self-managed-docs: ROOT:home:index.adoc
:page-connect-quickstart: redpanda-connect:get-started:quickstarts/index.adoc
:page-connect-docs: redpanda-connect:get-started:about.adoc
:page-adp-quickstart: redpanda-adp:get-started:signup.adoc
:page-adp-docs: redpanda-adp::index.adoc

Purpose

  • Enable ADP documentation rendering at /redpanda-adp/
  • Allow UI templates to dynamically resolve product card navigation links rather than hardcoding URLs
  • Support component renames without breaking homepage links

Test plan

  • Build site locally with adp-docs content
  • Verify ADP card appears on homepage with icon
  • Verify ADP docs render at /redpanda-adp/
  • Verify all product card links resolve correctly

Related

🤖 Generated with Claude Code

JakeSCahill and others added 2 commits April 22, 2026 12:39
- Add adp-docs repository to antora-playbook.yml content sources
- Add adp-docs to preview-antora-playbook.yml for Netlify previews
- Update llms.adoc ADP links from cloud-docs ai-agents paths to adp-docs

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add Agentic Data Plane card to docs homepage
- Add ADP icon (cable/connector icon in Redpanda orange)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@JakeSCahill JakeSCahill requested a review from a team as a code owner April 23, 2026 13:26
@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 23, 2026

Deploy Preview for redpanda-documentation failed. Why did it fail? →

Name Link
🔨 Latest commit 12b9b8b
🔍 Latest deploy log https://app.netlify.com/projects/redpanda-documentation/deploys/6a22d60c3545010008c60e82

JakeSCahill and others added 2 commits April 24, 2026 12:53
Update playbook to reference cloud-docs feature/remove-remote-mcp branch
which removes deprecated ADP documentation. Also removes adp-docs source
since ADP docs are not being released yet.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@JakeSCahill JakeSCahill marked this pull request as draft April 24, 2026 12:03
JakeSCahill and others added 3 commits April 24, 2026 13:48
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Update local and preview playbooks to use cloud-docs feature/remove-ai-agents
branch and remove adp-docs (not being released yet).

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Adds Antora resource ID attributes for home page product card navigation:

- :page-cloud-quickstart: / :page-cloud-docs: - Cloud product links
- :page-self-managed-quickstart: / :page-self-managed-docs: - Self-Managed links
- :page-connect-quickstart: / :page-connect-docs: - Connect product links
- :page-adp-quickstart: / :page-adp-docs: - Agentic Data Plane links

These attributes allow the UI template to dynamically resolve navigation
links rather than hardcoding them.

Related: redpanda-data/docs-ui#376
JakeSCahill and others added 3 commits June 5, 2026 10:50
…sting

Switch from jakepartusch/wait-for-netlify-action to kamranayub/wait-for-netlify-action
which uses the Netlify API to wait for the deployment matching the specific commit SHA,
rather than returning any available deploy preview.

Previously, tests ran against stale cached deploys from earlier commits because the
action would find and return an old preview deploy instantly (~1 second), before the
fresh build for the latest commit was ready. This caused tests to fail because they
were checking against outdated site structure where pages existed at /25.3/home/
instead of /streaming/25.3/home/.

The new action requires a NETLIFY_TOKEN secret but ensures tests always run against
the correct deploy for the current commit, preventing false failures from stale content.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Relocate the 'How to Use These Docs' page from data-platform component to
home component for better discoverability and organization.

Changes:
- Move how-to-use-these-docs.adoc from data-platform/modules/ROOT/pages/ to home/modules/ROOT/pages/
- Update home navigation to reference local file instead of cross-component xref
- Remove from data-platform navigation
- Add page alias for old data-platform path to maintain backward compatibility
- Add Agentic Data Plane (ADP) to documentation structure hierarchy
- Include ADP in key components list with xref to agentic-data-plane component
- Add "Choose your path" section for ADP users with quickstart link

The ADP component is sourced from the adp-docs repository and provides
documentation for AI agent infrastructure and agentic workflows.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@JakeSCahill JakeSCahill force-pushed the feature/add-adp-docs branch from 356bcc2 to b7f033b Compare June 5, 2026 10:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant