Skip to content

Add missing rpk profile and rpk cloud reference pages - #159

Merged
micheleRP merged 2 commits into
mainfrom
fix-rpk-broken-xrefs
Jul 28, 2026
Merged

Add missing rpk profile and rpk cloud reference pages#159
micheleRP merged 2 commits into
mainfrom
fix-rpk-broken-xrefs

Conversation

@JakeSCahill

@JakeSCahill JakeSCahill commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

Every full-site docs build currently logs 18 target of xref not found errors from this component. The rpk profile parent page single-sources its subcommand table from the docs repo, but the child pages the table links to don't exist here.

Scope reduced after review discussion with the ADP team: this PR now only adds single-source stubs for the 15 rpk profile subcommands plus their nav entries. The 12 rpk cloud stubs originally included here were dropped — #160 removes the rpk cloud subtree from this component entirely (rpk ai owns its own auth), which also removes the page emitting the remaining 3 xref errors. With both PRs merged (either order), adp-docs contributes zero xref errors.

Surfaced while checking build logs for the 26.2 GA release prep (companion fixes: redpanda-data/docs#1837, redpanda-data/cloud-docs#653).

Note: the Netlify preview check will stay red until the 26.2 GA merge lands on docs main (duplicate component version 26.1 during the release window — unrelated to this change). Re-run it after redpanda-data/docs#1840 merges.

The rpk profile and rpk cloud parent pages single-source their
subcommand tables from the docs repo, but the child pages the tables
link to did not exist in this component. Every full-site build logged
18 'target of xref not found' errors from adp-docs.

Adds single-source stubs for the 15 rpk profile subcommands and the
rpk cloud auth, byoc, and mcp families, plus nav entries.
@JakeSCahill
JakeSCahill requested a review from a team as a code owner July 28, 2026 16:07
@netlify

netlify Bot commented Jul 28, 2026

Copy link
Copy Markdown

Deploy Preview for redpanda-agentic-data-plane failed. Why did it fail? →

Name Link
🔨 Latest commit 9515cc1
🔍 Latest deploy log https://app.netlify.com/projects/redpanda-agentic-data-plane/deploys/6a68de3af3dcfd000833e372

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.
@JakeSCahill

JakeSCahill commented Jul 28, 2026

Copy link
Copy Markdown
Contributor Author

Reworked as proposed: dropped the 12 rpk cloud stubs and their nav entries, kept the 15 rpk profile stubs (9515cc1). #160 can merge in either order now.

@micheleRP micheleRP left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stubs and nav verified against the docs repo pages; thanks for reworking the rpk cloud split.

@micheleRP
micheleRP merged commit 3bc7d36 into main Jul 28, 2026
0 of 4 checks passed
@micheleRP
micheleRP deleted the fix-rpk-broken-xrefs branch 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.

2 participants