Skip to content

Fix Operator release notes links and move Cloud Topics in nav#1670

Merged
micheleRP merged 1 commit intoredpanda-data:mainfrom
david-yu:docs/operator-whats-new-fixes
Apr 14, 2026
Merged

Fix Operator release notes links and move Cloud Topics in nav#1670
micheleRP merged 1 commit intoredpanda-data:mainfrom
david-yu:docs/operator-whats-new-fixes

Conversation

@david-yu
Copy link
Copy Markdown
Contributor

Summary

  • Update Cloud Topics link in Operator v26.1.x release notes to point to the Kubernetes-specific page (manage:kubernetes/k-cloud-topics.adoc)
  • Update GBAC link in Operator v26.1.x release notes to point to the Kubernetes-specific page (manage:kubernetes/security/authorization/k-group-controller.adoc)
  • Move Cloud Topics underneath Manage Topics in the Kubernetes nav for better discoverability

Preview pages

Test plan

  • Verify Cloud Topics link in release notes resolves to /manage/kubernetes/k-cloud-topics/
  • Verify GBAC link in release notes resolves to /manage/kubernetes/security/authorization/k-group-controller/
  • Verify Cloud Topics appears under Manage Topics in the Kubernetes nav

🤖 Generated with Claude Code

- Cloud Topics: link to k-cloud-topics.adoc (Kubernetes-specific page)
- GBAC: link to k-group-controller.adoc (Kubernetes-specific page)
- Move Cloud Topics underneath Manage Topics in nav

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@david-yu david-yu requested a review from a team as a code owner April 14, 2026 21:28
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Apr 14, 2026

📝 Walkthrough

Walkthrough

This pull request reorganizes documentation navigation and updates cross-references. The "Cloud Topics" entry is moved from its previous location in the storage subsection to the main Kubernetes Manage section in the navigation file. Additionally, two cross-references in the operator release notes are updated to point to Kubernetes-specific documentation pages instead of general development/management pages.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

Suggested reviewers

  • micheleRP
  • JakeSCahill
🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the two main changes: fixing Operator release notes links and moving Cloud Topics in the navigation.
Description check ✅ Passed The description covers the key changes, includes preview pages and a test plan, but omits the required JIRA ticket reference and 'Checks' section from the template.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

🧹 Nitpick comments (1)
modules/get-started/pages/release-notes/operator.adoc (1)

46-46: Optional: prefer title-derived xrefs to reduce label drift.

At Line 46 and Line 52, consider xref:...[] (empty brackets) so link text follows the target page title automatically.

♻️ Optional cleanup
-Cloud Topics in Kubernetes provide the same cost savings and architectural benefits as self-managed deployments. You configure them declaratively through the Redpanda custom resource. For setup instructions, see xref:manage:kubernetes/k-cloud-topics.adoc[Cloud Topics for Kubernetes].
+Cloud Topics in Kubernetes provide the same cost savings and architectural benefits as self-managed deployments. You configure them declaratively through the Redpanda custom resource. For setup instructions, see xref:manage:kubernetes/k-cloud-topics.adoc[].

-GBAC simplifies permission management in Kubernetes environments by integrating with your identity provider's group structure. See xref:manage:kubernetes/security/authorization/k-group-controller.adoc[Group-based access control for Kubernetes] for configuration and usage details.
+GBAC simplifies permission management in Kubernetes environments by integrating with your identity provider's group structure. See xref:manage:kubernetes/security/authorization/k-group-controller.adoc[] for configuration and usage details.

Based on learnings: AsciiDoc linking prefers xref:...[] so the published title is sourced from the target doc automatically.

Also applies to: 52-52

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@modules/get-started/pages/release-notes/operator.adoc` at line 46, Replace
explicit link text in the AsciiDoc xrefs so the target page title is used
automatically: change instances like
xref:manage:kubernetes/k-cloud-topics.adoc[Cloud Topics for Kubernetes] (and the
other xref on the page) to xref:manage:kubernetes/k-cloud-topics.adoc[] so the
published link text is derived from the target document title.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@modules/get-started/pages/release-notes/operator.adoc`:
- Line 46: Replace explicit link text in the AsciiDoc xrefs so the target page
title is used automatically: change instances like
xref:manage:kubernetes/k-cloud-topics.adoc[Cloud Topics for Kubernetes] (and the
other xref on the page) to xref:manage:kubernetes/k-cloud-topics.adoc[] so the
published link text is derived from the target document title.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 43ba11ce-0731-478f-bde7-2c1399dc8a4a

📥 Commits

Reviewing files that changed from the base of the PR and between 77dbed5 and ad74bbc.

📒 Files selected for processing (2)
  • modules/ROOT/nav.adoc
  • modules/get-started/pages/release-notes/operator.adoc

Copy link
Copy Markdown
Contributor

@micheleRP micheleRP left a comment

Choose a reason for hiding this comment

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

lgtm!

@micheleRP micheleRP merged commit 35d2926 into redpanda-data:main Apr 14, 2026
3 checks passed
@netlify
Copy link
Copy Markdown

netlify bot commented Apr 14, 2026

Deploy Preview for redpanda-docs-preview ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit ad74bbc
🔍 Latest deploy log https://app.netlify.com/projects/redpanda-docs-preview/deploys/69deb19ca624650008602c06
😎 Deploy Preview https://deploy-preview-1670--redpanda-docs-preview.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.

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