Sync ADP docs with eng changes from week of 2026-05-04#15
Merged
Conversation
Eng-driven updates to match what shipped in cloudv2 between 2026-05-04
and 2026-05-08:
- Document the new per-model rate-card override editor on the budgets
page (cloudv2 #26200) and note AIP-160 filter expressions on
SpendingService (cloudv2 #26208) plus correct cache-write token
attribution on Anthropic streaming (cloudv2 #26209).
- Add a Metabase managed MCP deep-dive (cloudv2 1f73266688) with a
catalog row and nav entry.
- Add a Revoke all tokens section on the Remote MCP Clients page
covering the new RevokeAllTokens RPC, the rpk ai oauth-client
revoke-tokens CLI, and auto-revocation on Client deletion
(cloudv2 #26192).
- Cross-link OAuth Client revocation from the OAuth Providers
disambiguation note.
- Note that rpk ai help, version, and unknown subcommands no longer
prompt for authentication (redpanda #30360).
- Cross-link the new rate-card override section from the dashboard
overview and from the transcripts page; clarify Anthropic
cache-creation token attribution in the transcripts cost section.
Draft the two empty BYOA stubs against current cloudv2 state:
- agents/byoa-register.adoc: forward-looking how-to anchored on the
AgentRegistryService API surface and the well-known A2A agent-card
contract. The BYOA arm of AgentCreate.agent_type and the UI route
are not yet defined; TODO comments mark every spot that needs the
click-by-click flow once eng confirms.
- observability/byoa-telemetry.adoc: minimum required spans contract
(resource attributes plus gen_ai.* span attributes), recommended
enrichment, span hierarchy, validation walkthrough, and
troubleshooting.
Strip forward-looking version framing across the repo:
- Delete the agent-network.adoc and violations.adoc stubs (their
content was entirely "Coming in a later release" placeholder
framing) and remove their nav entries.
- Drop "What's coming in a later release" sections from the dashboard
overview and budgets pages; move roadmap items into TODO comments
so reviewers can see them but customer prose stays current-state.
- Remove all V0/V1/V2/GA/general availability/2026-06-15 framing from
customer prose (still allowed in TODO comments). Replace
"in a later release", "today's release", "current release",
"currently planned", "available today" qualifiers throughout.
- Mark four pre-existing forward-looking phrases with
TODO(review-before-publish) so reviewers can grep for the tag and
decide each before merge: Cost & usage "in development" admonitions
on ai-gateway/overview.adoc and connect-agent.adoc, Auth0/Zitadel
IdP migration mention on remote-mcp-clients.adoc, "not currently
supported" cross-agent calling on agents/overview.adoc, and
"currently registered" softener on managed-catalog.adoc.
Apply docs-team-standards style fixes to all new writing:
- Convert em dashes in bullet definition lists to colons; convert
mid-sentence em dashes to commas, parens, or sentence breaks.
- Replace banned terms: "via" reworded; "Understand" learning
objective verb replaced with "Identify".
- Add intro text before tables, lists, and code blocks under
every heading that previously had none.
- Remove directional language ("below", "in the previous section");
reword as "in this section" or by section name.
- Remove quotation marks per the no-quotes rule.
npm run build reports zero adp-docs errors.
Co-Authored-By: Claude Opus 4.7 (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. |
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.
Summary
Catch-up sweep against cloudv2 changes that landed between 2026-05-04 and 2026-05-08, plus drafts for two empty BYOA stubs and a docs-team-standards style pass on all new writing.
Eng evidence
[AI-953] feat: adds governance v0 (without governator)— first governance UI releaseSpendingServiceAIP-160 filter expressions; server-derivedtotal_tokenscache_creation_input_tokensextraction fixRevokeAllTokensRPC +rpk ai oauth-client revoke-tokensCLI + auto-revoke on lifecycle eventsapps/aigw/docs/metabase-mcp.mdrpk ai help/version/<unknown>no longer prompts authenticationapps/adp-ui/src/routes/governance/is now the default top-level route whengovernance_tab_enabledis onWhat's in this PR
Eng-sync content updates
modules/governance/pages/budgets.adoc— new Override per-model pricing section (input / output / cache-write at 5m / 1h / unknown TTL), AIP-160 filter callout onSpendingFilter, cache-write attribution note for streaming Anthropic responsesmodules/governance/pages/dashboard/overview.adoc— new filter-scoping note (cards honor provider/model/user filters), cross-link to rate-card overridesmodules/mcp/pages/managed/metabase.adoc(new) — full Metabase deep-dive matching the Workday / Slack / Ramp patternmodules/mcp/pages/managed/managed-catalog.adoc— Metabase row in the Database sectionmodules/ROOT/nav.adoc— Metabase nav entrymodules/integrations/pages/remote-mcp-clients.adoc— new Revoke all tokens subsection (UI +rpk ai oauth-client revoke-tokensCLI + auto-revoke on Client deletion)modules/mcp/pages/oauth-providers.adoc— cross-link to Client revocation in the disambiguation notemodules/ai-gateway/pages/connect-agent.adoc— note thatrpk ai help / version / <unknown>no longer prompts authenticationmodules/observability/pages/transcripts.adoc— Anthropic cache-creation token note + cross-link to budgets rate-card sectionBYOA drafts
modules/agents/pages/byoa-register.adoc— forward-looking how-to anchored onAgentRegistryService.CreateAgentand the well-known A2A/.well-known/agent-card.jsoncontract. TODO comments mark each spot that needs the click-by-click flow once the BYOA arm ofAgentCreate.agent_typelands and the UI route exists.modules/observability/pages/byoa-telemetry.adoc— minimum required spans contract (service.nameresource +gen_ai.conversation.id/gen_ai.operation.name/gen_ai.request.model/gen_ai.usage.input_tokens/gen_ai.usage.output_tokens), recommended enrichment, span hierarchy, validation walkthrough, troubleshooting.Forward-looking-framing cleanup (across the repo)
agent-network.adocandviolations.adocstubs (their content was 100% "Coming in a later release" placeholder framing); removed their nav entries.dashboard/overview.adocandbudgets.adoc; moved roadmap items into// TODO:comments.// TODO:comments per project policy). Replaced "in a later release", "today's release", "current release", "currently planned", "available today" qualifiers throughout.// TODO(review-before-publish):so a reviewer cangrepthe tag and decide each before merge:ai-gateway/overview.adocandai-gateway/connect-agent.adoc— Cost & usage section "in development"integrations/remote-mcp-clients.adoc— "Auth0 today, Zitadel in a future release" IdP migration mentionagents/overview.adoc— "Cross-agent calling between separate agents is not currently supported"mcp/managed/managed-catalog.adoc— "every managed type currently registered"docs-team-standards style pass on new writing
via(4 occurrences), andUnderstandlearning-objective verb replaced withIdentify.below,in the previous section) in new prose; reworded asin this sectionor referenced by section name.Out of scope (deferred)
enable_internal_listener_and_service_accountsfeature flag; not yet GA.docs#1691) — held until GA week.transcripts.adocfilter/column tables and other older sections — separate cleanup scope.Open questions for the reviewer
Tagged in the source as
// TODO:and// TODO(review-before-publish):—grep -rn "TODO(review-before-publish)" modules/lands on each:adp-production)SpendingServiceoverrides surface inGetSpendingBreakdownresponsesagent_typeproto variant name and registration UI surfaceservice.nameresource attribute should match a registeredAgentRegistryServiceresource nameTest plan
npm run buildreports zero adp-docs errors (the 6 errors in the build log originate from upstreamredpanda-data/docsandredpanda-data/cloud-docsand are pre-existing).npm run serverenders all four new / heavily-edited pages without broken xrefs:governance/dashboard/overview/— IMPORTANT box and roadmap section gone; new filter-scoping NOTE rendersgovernance/budgets/— new Override section renders,override-per-model-pricinganchor resolvesmcp/managed/metabase/— new deep-dive renders; nav entry visible; catalog row presentagents/byoa-register/andobservability/byoa-telemetry/— BYOA drafts render with TODO markersgovernance/dashboard/agent-network/andviolations/— return 404 (deleted as expected)grep -rn "TODO(review-before-publish)" modules/returns 5 spots flagged for reviewer decision before merge.adp-productionto resolve TODO markers in budgets.adoc, transcripts.adoc, dashboard/overview.adoc against the V0 governance UI.AgentCreate.agent_typeBYOA variant and the UI route.🤖 Generated with Claude Code