Skip to content

docs: point production K8s pages at the local kind/minikube guide (DOC-517) - #1888

Open
JakeSCahill wants to merge 1 commit into
mainfrom
DOC-517-local-guide-pointer
Open

docs: point production K8s pages at the local kind/minikube guide (DOC-517)#1888
JakeSCahill wants to merge 1 commit into
mainfrom
DOC-517-local-guide-pointer

Conversation

@JakeSCahill

@JakeSCahill JakeSCahill commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Resolves DOC-517: a user browsing the production deployment docs had no signpost to the local kind/minikube guide and had to find it through search.

Adds a TIP to the two production entry points (k-production-workflow and k-production-deployment) linking the local development guide. The xref target is the existing local-guide.adoc page. Two-line change, no structural impact. The Netlify preview validates the links.

🤖 Generated with Claude Code

…C-517)

Users browsing the production workflow or deployment page had no signpost
to the local development guide. Add a TIP on both entry points.
@JakeSCahill
JakeSCahill requested a review from a team as a code owner August 6, 2026 11:08
@netlify

netlify Bot commented Aug 6, 2026

Copy link
Copy Markdown

Deploy Preview for redpanda-docs-preview ready!

Name Link
🔨 Latest commit 91cff5b
🔍 Latest deploy log https://app.netlify.com/projects/redpanda-docs-preview/deploys/6a746b26541db90008b082f7
😎 Deploy Preview https://deploy-preview-1888--redpanda-docs-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai

coderabbitai Bot commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

Added tips to the production Kubernetes deployment and workflow pages. The tips direct users who need local development or testing guidance to the kind and minikube deployment guide.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Possibly related PRs

Suggested reviewers: feediver1

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and concisely describes the documentation change and identifies the local kind/minikube guide.
Description check ✅ Passed The description explains the change, links the Jira ticket, identifies affected pages, and notes preview validation, but omits template headings and a preview URL.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch DOC-517-local-guide-pointer

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.

@coderabbitai coderabbitai Bot 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.

🧹 Nitpick comments (1)
modules/deploy/pages/redpanda/kubernetes/k-production-deployment.adoc (1)

11-12: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Use empty xref brackets for both local-guide links.

Both tips hard-code display text for the same destination. Use xref:deploy:redpanda/kubernetes/local-guide.adoc[] so the published link text follows the target document title.

  • modules/deploy/pages/redpanda/kubernetes/k-production-deployment.adoc#L11-L12: Replace the hard-coded link label with an empty xref label.
  • modules/deploy/pages/redpanda/kubernetes/k-production-workflow.adoc#L10-L11: Replace the hard-coded link label with an empty xref label.

Based on learnings, prefer empty xref brackets in AsciiDoc links.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@modules/deploy/pages/redpanda/kubernetes/k-production-deployment.adoc` around
lines 11 - 12, Replace the hard-coded local-guide link label with an empty xref
label in modules/deploy/pages/redpanda/kubernetes/k-production-deployment.adoc
lines 11-12 and
modules/deploy/pages/redpanda/kubernetes/k-production-workflow.adoc lines 10-11,
preserving the existing destination so the published text comes from the target
document title.

Source: Learnings

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@modules/deploy/pages/redpanda/kubernetes/k-production-deployment.adoc`:
- Around line 11-12: Replace the hard-coded local-guide link label with an empty
xref label in
modules/deploy/pages/redpanda/kubernetes/k-production-deployment.adoc lines
11-12 and modules/deploy/pages/redpanda/kubernetes/k-production-workflow.adoc
lines 10-11, preserving the existing destination so the published text comes
from the target document title.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 004c466d-a58b-402e-b408-cc1d99e6cfc2

📥 Commits

Reviewing files that changed from the base of the PR and between 62d6494 and 91cff5b.

📒 Files selected for processing (2)
  • modules/deploy/pages/redpanda/kubernetes/k-production-deployment.adoc
  • modules/deploy/pages/redpanda/kubernetes/k-production-workflow.adoc

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