Update ADP docs for May 4 batch (rpk ai, Bedrock GA, governance V0)#11
Merged
Update ADP docs for May 4 batch (rpk ai, Bedrock GA, governance V0)#11
Conversation
- Migrate rpai CLI references to rpk ai plugin (install via rpk plugin install ai) - Add Bedrock GA content: inference profiles (us./eu./apac./global. prefixes), IAM patterns for foundation models vs profiles, troubleshooting for Claude 4.6+ profile-only constraint - New how-to: Configure an OAuth Provider, including AI-893 dataplane_aigateway_oauthprovider_attach permission - New managed MCP deep-dives: Workday, Zendesk, Ironclad, Ramp (+ catalog rows + nav entries) - New integrations page: Remote MCP clients (Claude Desktop, ChatGPT, Gemini Apps) with three-resource architecture and two-step OAuth flow - Rewrite governance dashboard overview to V0 prototype design (4 KPI cards, spending chart with hierarchical filters, simplified agents list, drill-down navigation) - Rename "Trust & Governance" section to "Governance" - Add CLI alternatives sections to test-tools.adoc, create-server.adoc, user-delegated-oauth.adoc covering rpk ai mcp tools/get and --user-oauth-* flags - Update LLM Providers list-view documentation with the new Spend (7d) column - Resolve TODO markers linking to the new oauth-providers.adoc Pass docs-team-standards review: drop em dashes (replace with colons, parens, sentence splits), banned terms (via, please, we), banned learning-objective verbs (understand), step-numbered headings, and quotation marks in prose (use italics). 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. |
Capitalize the first word in patterns like `* *Edit*: open the...` → `* *Edit*: Open the...` across the May 4 batch of changed files. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Extends the previous capitalization pass to cover patterns like `* xref:foo[Link]: lowercase` and `* \`code\`: lowercase` so they match the `* *Bold*: Capitalized` convention. Also picks up nested bullets where a bold label appears mid-bullet (`* The *Resource*: ...`). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- Replace ' — ' with ': ' (or ; / split / parens) across pre-existing files in the May 4 batch that still had em dashes. - Clean up double-colon constructions introduced by the bulk swap where an em dash was acting as a parenthetical bracket. - Capitalize the first word after a colon in section headings (Example: change → Example: Change). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Per docs-team-standards (no empty sections; intro before child content), add a one-line lead-in before every section that previously opened directly with a list or table. Touches Prerequisites, Configure, Tools, Troubleshooting, Out of scope, Related topics, and the credential-setup sections across slack, workday, zendesk, ironclad, ramp, oauth-providers, and remote-mcp-clients. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Per docs-team-standards: Next steps sections should be a clean list of bare links. Remove descriptions, prose intros, sub-headers, and ifdef wrappers across every page and partial in adp-docs. For two pages with no recoverable xrefs (no link in the original content), restore reasonable links (budgets) or drop the empty section (routing-cel). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Per docs-team-standards, Next steps and Related topics are the only two heading types that should not have intro text before the list. Apply the same bare-xref-bullet treatment that Next steps got to Related topics across the new MCP and integration pages. For oauth-providers, split the multi-xref managed-MCP bullet into separate bullets (one per managed type). Co-Authored-By: Claude Opus 4.7 (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.
Summary
Folds in the changes from the May 4 input batch (Slack threads, demo screenshots, cloudv2 sweep) and a follow-up docs-team-standards pass.
rpai→rpk aiplugin (install viarpk plugin install ai).us./eu./apac./global.prefixes), IAM patterns for foundation models vs profiles, troubleshooting for the Claude 4.6+ profile-only constraint.dataplane_aigateway_oauthprovider_attachpermission.Trust & GovernancetoGovernance.test-tools.adoc,create-server.adoc,user-delegated-oauth.adoccoveringrpk ai mcp tools,rpk ai mcp get, and the--user-oauth-provider/--user-oauth-scopesflags.Spend (7d)column.// TODO: link the OAuth Provider how-to once it exists.markers.via,please,we), banned learning-objective verbs (understand), step-numbered headings, and quotation marks in prose (use italics).18 files changed (+1668 / −167). Six new pages, twelve modified.
Preview pages
Test plan
npm run build); no errors or warnings on changed files.mcp/oauth-providers/— full page including AI-893 permission detailmcp/managed/workday/,mcp/managed/zendesk/,mcp/managed/ironclad/,mcp/managed/ramp/integrations/remote-mcp-clients/— three-resource architecture, OAuth flow stepsgovernance/dashboard/overview/— V0 prototype banner renders, all sections presentoauth-providers.adoclinked fromuser-delegated-oauth.adocandmanaged/slack.adoc; new managed MCPs appear inmanaged/managed-catalog.adocand the nav.Governance(notTrust & Governance) in the sidebar.ai-gateway/configure-provider/renders the ARN table cleanly with the\{region}escapes intact.🤖 Generated with Claude Code