Skip to content

Conversation

@paulohtb6
Copy link
Collaborator

Description

Resolves https://redpandadata.atlassian.net/browse/
Review deadline:

Page previews

Checks

  • New feature
  • Content gap
  • Support Follow-up
  • Small fix (typos, links, copyedits, etc)

@paulohtb6 paulohtb6 requested a review from a team as a code owner November 11, 2025 17:18
@netlify
Copy link

netlify bot commented Nov 11, 2025

Deploy Preview for redpanda-docs-preview ready!

Name Link
🔨 Latest commit 6540a8d
🔍 Latest deploy log https://app.netlify.com/projects/redpanda-docs-preview/deploys/69136fdeaf00e100080a71af
😎 Deploy Preview https://deploy-preview-1448--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.

@paulohtb6 paulohtb6 changed the base branch from main to beta November 11, 2025 17:18
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Nov 11, 2025

Caution

Review failed

Failed to post review comments

📝 Walkthrough

Walkthrough

This pull request updates the Redpanda documentation site for version 25.3, introducing new disaster recovery features and reorganizing documentation structure. Changes include: updating Antora version configuration from 25.2 to 25.3 with prerelease flags; adding the beta branch to GitHub Actions build triggers; adding comprehensive Shadowing disaster recovery documentation (overview, setup, monitoring, failover, and runbook); restructuring Admin API documentation to distinguish legacy RESTful and ConnectRPC endpoints; adding GCP BigLake integration for Iceberg topics; reorganizing Schema Registry documentation around modes (read-write, read-only, import); updating cross-references throughout the nav and related documentation; and modernizing various cluster maintenance and monitoring documentation sections.

Sequence Diagram(s)

Sequence diagrams are not applicable here, as these changes are primarily documentation content additions, reorganization, and configuration updates without introducing new system interactions or control flows.

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~60 minutes

Areas requiring extra attention:

  • Disaster Recovery / Shadowing section (modules/deploy/pages/redpanda/manual/disaster-recovery/shadowing/): Multiple new comprehensive documentation files added; verify technical accuracy of failover procedures, command examples, and prerequisites, particularly failover-runbook.adoc with detailed rpk commands and troubleshooting steps
  • Cross-reference consistency: Updates span 40+ files with cross-reference changes; verify all xref links in nav.adoc, properties, and partials resolve correctly (e.g., configure-availability.adoc → configure-client-connections.adoc transitions)
  • Antora configuration changes (.github/workflows/build.yml, antora.yml, local-antora-playbook.yml): Verify version bumps, branch triggers, and playbook source branch additions are syntactically correct and aligned across all three files
  • Conditional content blocks: New ifdef/ifndef blocks added for env-cloud and env-kubernetes; verify conditions are placed correctly and surrounding content flows properly
  • Admin API documentation restructuring: New ConnectRPC endpoint documentation (v2) alongside legacy endpoints (v1); ensure both endpoint types are clearly distinguished and examples are accurate for both

Possibly related PRs

  • dr: adds shadowing docs #1381: Adds overlapping Shadowing disaster-recovery documentation and related navigation entries, directly overlapping with this PR's disaster recovery content
  • DOC-1643 single source client connections in docs #1357: Modifies client-connections documentation area and updates cluster-properties references with env-cloud gating, overlapping with manage-throughput and configure-client-connections changes
  • Update build.yml #1439: Updates .github/workflows/build.yml to add beta branch to push.branches trigger, a direct duplicate of this PR's workflow change

Suggested reviewers

  • JakeSCahill
  • mattschumpert

Pre-merge checks and finishing touches

❌ Failed checks (1 warning, 1 inconclusive)
Check name Status Explanation Resolution
Description check ⚠️ Warning The pull request description is incomplete; it contains only placeholder template text with no actual description of changes, no JIRA ticket link filled in, no review deadline, and no page preview links provided. Fill in the description template with the actual JIRA ticket number, a clear summary of changes, relevant page previews, and select the appropriate check box (likely 'Small fix' based on the large changeset).
Title check ❓ Inconclusive The title 'Remove dupe' is vague and does not clearly convey what duplication was removed or which files/changes are involved. Provide a more specific title that describes what duplicate was removed (e.g., 'Remove duplicate include directive in remote-read-replicas.adoc').
✅ Passed checks (1 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch remove-dupe

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.

@paulohtb6 paulohtb6 merged commit db050af into beta Nov 12, 2025
5 checks passed
@paulohtb6 paulohtb6 deleted the remove-dupe branch November 12, 2025 19:48
paulohtb6 added a commit that referenced this pull request Nov 19, 2025
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.

3 participants