docs: refresh ADP overview positioning for GA#62
Merged
Conversation
Reframe the ADP overview around governance infrastructure: lead with the agent governance gap, position ADP as the governed layer between agents and data (identity, mediated access, recorded actions), and add a neutral open-standards/no-lock-in beat (MCP, OAuth, OpenTelemetry, Kafka protocol). Elevate the Governance Dashboard as the headline differentiator. Enrich the Governance Dashboard Overview intro with flux-safe value framing, leaving the verified procedural detail unchanged. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Use 'agent registry list' and 'catalog'/'full list' consistently across the agent creation, MCP overview, and quickstart pages. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
✅ Deploy Preview for redpanda-agentic-data-plane ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Replace 'the 36 managed MCP server types' with durable wording so the count doesn't drift as the catalog grows. The managed-catalog page itself remains the authoritative enumeration; mcp-overview now describes the catalog by category breadth. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Use 'Setup guide' consistently in the managed catalog column header, link text, and prose references, plus create-server.adoc and jira.adoc. The linked per-server pages cover auth and configuration setup, so 'setup guide' is clearer than the informal 'deep dive'. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Trim Related topics/Next steps sections to no more than 3 links, rename all 'Related topics' headings to 'Next steps' (no page had both), and fix a bullet that carried trailing prose after the xref. For oauth-providers, replace the six individual managed-server links with the Managed catalog link so the list is both shorter and complete. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Remove the generic 'Access to the Agentic Data Plane / Redpanda ADP' prerequisite bullet from pages whose readers are already in ADP, and reword the transcripts prerequisite to lead with the required permission rather than 'access to the Transcripts view'. Specific role and permission prerequisites (quickstart, dashboard) are unchanged. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…vider' The page documents pointing your own application/code at an LLM provider's proxy URL (SDKs, OIDC, rpk ai), which is distinct from building declarative agents in the Build Agents section. The old title invited confusion with that flow. Retitle the page and nav entry, refresh the intro/description away from 'AI Gateway' branding, and update all xref link text. Filename and the broader gateway rewording are left to the AI Gateway de-emphasis PR. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
… Your App to AI Gateway' AI Gateway is staying as a concept (not yet surfaced in the UI, but the concept persists), so restore the AI Gateway wording in the intro and description and set the title to 'Connect Your App to AI Gateway'. Updates the nav entry and all xref link text to match. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…s Next steps Update stale former-title link text to the current page titles (gateway/overview, both permissions pages, monitor/concepts), and use the managed-catalog page title in Next steps links while keeping the concise 'Managed catalog' text in inline prose. Rename the guardrails overview 'Where to go next' section to 'Next steps' with clean bare-link bullets. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Refreshes the ADP overview positioning for GA and bundles a set of related docs cleanups (terminology, navigation/Next steps, prerequisites, link text, and one page retitle) across 40 pages. No feature-scope/accuracy claims were changed here — those are tracked separately.
Overview positioning (
get-started/adp-overview)Governance Dashboard Overview (
control/dashboard/overview)Terminology & accuracy
Navigation & Next steps
oauth-providers, replaced six individual managed-server links with the single Managed catalog link (shorter and complete).Prerequisites
Page retitle
gateway/connect-agent: "Connect Your Agent" → "Connect Your App to AI Gateway". This page is about pointing your own application/code at the LLM proxy (SDKs, OIDC,rpk ai) — a different workflow from the Build Agents declarative-agent flow, and the old title invited confusion. AI Gateway terminology is retained (the concept is staying). Filename unchanged; broader gateway rewording is out of scope.Preview
🤖 Generated with Claude Code