Skip to content

Reframe ADP as standalone, and drop MCP-built-on-Connect claim#9

Merged
micheleRP merged 3 commits intomainfrom
remove-cluster-framing
Apr 29, 2026
Merged

Reframe ADP as standalone, and drop MCP-built-on-Connect claim#9
micheleRP merged 3 commits intomainfrom
remove-cluster-framing

Conversation

@micheleRP
Copy link
Copy Markdown
Contributor

@micheleRP micheleRP commented Apr 29, 2026

Two related reframings, shipped together.

1 · ADP as a standalone product surface (commit 9fbc45e)

  • Replaces "open your Redpanda Cloud cluster", "in the Redpanda Cloud Console", "expand the ADP section in the sidebar" and similar cluster-embedded UI flows with standalone "Sign in to ADP" / "in ADP" / "in the ADP UI" phrasing across 53 files (pages and partials).
  • Drops "ADP lives inside Redpanda Cloud" framing in concept text, page descriptions, and learning objectives. "AI agents in Redpanda Cloud..." → "ADP AI agents...", "Redpanda Cloud Console" → "ADP UI", "Redpanda Cloud token" → "ADP token", etc.
  • Removes three obsolete `// TODO` comments that tracked this rewrite (in `ai-gateway/overview.adoc`, `ai-gateway/configure-provider.adoc`, `ai-gateway/connect-agent.adoc`).

2 · MCP no longer "built on Redpanda Connect" (commit 7bbcb45)

  • ROOT/pages/index.adoc: rewrite the MCP servers paragraph — drop "Built on Redpanda Connect", drop "wrap the same proven connectors", and drop the implied "300 connectors" claim that suggested MCP inherits the Connect catalog. Keep the actual value props (lightweight, OIDC, deterministic policies, YAML, attack-prevention).
  • observability/pages/concepts.adoc: in the MCP trace-structure docs, swap "Redpanda Connect layer / processing / service operations / processor" descriptions for neutral "MCP server" wording. Removes the Redpanda Connect row from the layer table, drops the "redpanda-connect for internal processing" reference in the span-attribute description, and updates the layer-hierarchy ASCII diagram.

What this does not change (intentional)

  • `xref:redpanda-cloud:...` cross-references to cloud-docs pages.
  • Auth endpoint URLs (`auth.prd.cloud.redpanda.com`).
  • URL schemes that include `cluster-id` segments (e.g., `aigw..clusters.rdpa.co`) — these are real URL patterns and the new scheme isn't defined yet. Tracked for a follow-up rewrite under ADP Docs Plan Workflow #11.
  • The BYOA telemetry page (`observability/pages/ingest-custom-traces.adoc`): user-visible "Redpanda Cloud cluster" was reframed to "Redpanda BYOC cluster" since today's ingestion legitimately runs on a Redpanda BYOC cluster (Connect is the user's own ingestion pipeline tool here, not MCP internals). Internal `// TODO` comments tracking the eventual standalone-ADP rewrite remain.
  • Apache Kafka / Elasticsearch cluster references in MCP docs unrelated to ADP framing.
  • Agents docs that say "agents have access to 300+ Redpanda Connect connectors" stay as-is — agents are a separate workflow from MCP and the Connect linkage there isn't part of this update.

Preview pages

  • Redpanda Agentic Data Plane — start at the home page (MCP servers section) and the AI Gateway Overview to see both reframings live.

Test plan

  • Build locally and visit `http://localhost:5002/redpanda-adp/ai-gateway/overview/#whats-in-the-ui\` — confirm the cluster-embedded "open your cluster, expand ADP in the sidebar" wording is gone and replaced with the standalone "In the ADP UI you'll find four areas" framing.
  • On the home page, confirm the MCP servers paragraph no longer says "Built on Redpanda Connect" or claims MCP wraps Connect connectors.
  • Spot-check the agent quickstart and tutorials — sign-in steps no longer say "Navigate to your cluster".
  • Confirm `grep -rn "Redpanda Cloud Console" modules/` returns nothing.
  • Confirm the observability Transcripts and AI Observability page layer table no longer contains a Redpanda Connect row.
  • Confirm `xref:redpanda-cloud:...` cross-references still resolve in the build (no new broken xrefs).

🤖 Generated with Claude Code

Replaces "open your Redpanda Cloud cluster", "in the Redpanda Cloud
Console", "Redpanda Cloud sidebar" and similar cluster-embedded UI
flows with standalone "Sign in to ADP" / "in ADP" / "in the ADP UI"
phrasing across pages and partials. Removes the "ADP lives inside
Redpanda Cloud" framing in concept text, descriptions, and learning
objectives. Drops three TODO comments that tracked this rewrite.

Preserves: BYOC environment references where the underlying Redpanda
BYOC cluster is the legitimate Connect-pipeline host (today's BYOA
telemetry path); xref:redpanda-cloud:... cross-references; Apache
Kafka / Elasticsearch cluster references unrelated to ADP framing;
auth endpoint URLs (auth.prd.cloud.redpanda.com); and current URL
schemes that include cluster-id segments — those are tracked for a
follow-up rewrite under ADP Docs Plan Workflow #11.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@micheleRP micheleRP requested a review from a team as a code owner April 29, 2026 19:31
@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 29, 2026

Deploy Preview for redpanda-agentic-data-plane ready!

Name Link
🔨 Latest commit fa17939
🔍 Latest deploy log https://app.netlify.com/projects/redpanda-agentic-data-plane/deploys/69f2717d555eb0000894698c
😎 Deploy Preview https://deploy-preview-9--redpanda-agentic-data-plane.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

MCP no longer rides on Redpanda Connect, so reframe the MCP product
description and the related observability trace structure:

- ROOT/pages/index.adoc: rewrite the MCP servers paragraph; drop the
  "Built on Redpanda Connect" / "wrap the same proven connectors" /
  "300 connectors" claims. Keep the actual value props (lightweight,
  OIDC, deterministic policies, YAML, security).
- observability/pages/concepts.adoc: in the MCP trace structure
  documentation, replace "Redpanda Connect layer / processing /
  service operations / processor" descriptions with neutral "MCP
  server" wording. Removes the "Redpanda Connect" row from the layer
  table, drops the "redpanda-connect for internal processing"
  reference, and updates the layer-hierarchy ASCII diagram.

Out of scope: the BYOA telemetry page (ingest-custom-traces.adoc)
still references Redpanda Connect — that's the user's own
trace-ingestion pipeline (Connect is the receiver), not MCP internals.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@micheleRP micheleRP changed the title Reframe ADP as standalone, not embedded in Redpanda Cloud Reframe ADP as standalone, and drop MCP-built-on-Connect claim Apr 29, 2026
Self-review surfaced two consistency issues:

- service-account-authorization.adoc: line 4 had been swapped from
  "Redpanda Cloud automatically creates" to "ADP automatically
  creates" but still said "to your cluster". Finish the rewrite by
  changing the object to "ADP resources".
- ai-gateway/overview.adoc: align the page :description: attribute
  ("AI Gateway is ADP's managed proxy") with the body wording so
  search/snippets don't show "Redpanda's" alongside "ADP's".

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@micheleRP micheleRP merged commit fa2d8b4 into main Apr 29, 2026
4 checks passed
@micheleRP micheleRP deleted the remove-cluster-framing branch April 29, 2026 21:05
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