Skip to content

docs: remove stale Redpanda Cloud dependencies from the CLI and agent guides - #160

Open
micheleRP wants to merge 3 commits into
mainfrom
docs/remove-cloud-dependency-references
Open

docs: remove stale Redpanda Cloud dependencies from the CLI and agent guides#160
micheleRP wants to merge 3 commits into
mainfrom
docs/remove-cloud-dependency-references

Conversation

@micheleRP

@micheleRP micheleRP commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

Description

Removes stale Redpanda Cloud dependencies from the CLI and agent guides, and deletes retired or orphaned content.

  • Drops the incorrect prerequisite that rpk ai requires an rpk cloud sign-in. The rpk ai plugin owns its own login (rpk ai auth login) and environment selection, so the sign-in troubleshooting row now points at rpk ai auth login.
  • Corrects the gateway host in example URLs.
  • Corrects the auto-created service account name and principal forms, and routes readers to service accounts through the agent's Connect tab.
  • Rewords Redpanda Cloud references to Agentic Data Plane where the surface described is Agentic Data Plane. References that are accurate (for example, Organization IAM and bearer-token authentication) are kept.
  • Removes the rpk cloud reference pages and their nav subtree. Page aliases redirect the five retired URLs to the CLI guide.
  • Deletes orphaned partials that no page includes.

User impact

CLI users no longer see a false sign-in prerequisite, and example URLs match the real gateway host. Bookmarks to the retired rpk cloud pages redirect to the CLI guide.

Notes for reviewers

  • The role binding description in the service account partial (Writer role at cluster scope) is intentionally unchanged; its verification is tracked separately.
  • Redirects verified in a local build: all five retired URLs generate redirect stubs to the CLI guide.

Page preview

https://deploy-preview-160--redpanda-agentic-data-plane.netlify.app/agentic-data-plane/cli/ (pending deploy approval)

Checks

  • Local Antora build
  • Redirect stubs for the five retired URLs verified in the built output
  • No remaining references to the deleted pages or partials

🤖 Generated with Claude Code

… guides

- Drop the incorrect prerequisite that rpk ai requires an rpk cloud sign-in,
  and point the sign-in troubleshooting row at rpk ai auth login instead
- Correct the gateway host in example URLs
- Correct the auto-created service account name and principal forms, and
  route readers to service accounts through the agent's Connect tab
- Reword Redpanda Cloud references to Agentic Data Plane where the surface
  described is Agentic Data Plane, keeping the ones that are accurate
- Remove the rpk cloud reference pages and nav subtree, adding page aliases
  so the retired URLs redirect to the CLI guide
- Delete orphaned partials that no page includes

Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
@micheleRP
micheleRP requested a review from a team as a code owner July 28, 2026 16:28
@netlify

netlify Bot commented Jul 28, 2026

Copy link
Copy Markdown

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

Name Link
🔨 Latest commit c8b4a3b
🔍 Latest deploy log https://app.netlify.com/projects/redpanda-agentic-data-plane/deploys/6a69dd4c7ddafc0007fdc18e
😎 Deploy Preview https://deploy-preview-160--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.

JakeSCahill added a commit that referenced this pull request Jul 28, 2026
Per review discussion: #160 removes the rpk cloud subtree from this
component entirely (rpk ai owns its auth), which also removes the
page emitting the rpk cloud xref errors. This PR now only adds the
15 rpk profile subcommand stubs and their nav entries.
- Replace rpk ai llm with rpk ai llm-provider and rpk ai mcp with
  rpk ai mcp-server in all examples and prose (the old names remain
  as CLI aliases; the new forms match rpk ai help output)
- Update the environment variable table: environment selection has no
  environment variable, and the -p short flag no longer exists

Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
@micheleRP
micheleRP force-pushed the docs/remove-cloud-dependency-references branch from 532e795 to cd91079 Compare July 28, 2026 17:16
@micheleRP
micheleRP requested a review from simon0191 July 28, 2026 17:17
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