Refine properties list

[paulohtb6]

Description

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

Page previews

Preview

Checks

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

[netlify]

✅ Deploy Preview for redpanda-docs-preview ready!

Name	Link
🔨 Latest commit	0167455
🔍 Latest deploy log	https://app.netlify.com/projects/redpanda-docs-preview/deploys/69151699e6d52e00086e7492
😎 Deploy Preview	https://deploy-preview-1451--redpanda-docs-preview.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

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

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

📝 Walkthrough

Walkthrough

This pull request updates documentation for a Redpanda 25.3 beta release. Changes include bumping version metadata from 25.2 to 25.3-beta in Antora configuration files, adding a beta branch to the CI/CD build workflow, and restructuring navigation to introduce a comprehensive Disaster Recovery section featuring Shadowing (asynchronous cross-cluster replication). New documentation pages cover Shadowing setup, monitoring, failover procedures, and emergency runbooks. Additional updates introduce Admin API (ConnectRPC) endpoints documentation, expand Iceberg support to Google Cloud BigLake, migrate Schema Registry documentation for new IMPORT mode, and reorganize existing cluster maintenance and recovery documentation with updated cross-references. The PR also includes new shared content partials for emergency callouts and removes/relocates several existing pages per the new navigation structure.

Sequence Diagram(s)

sequenceDiagram
    actor User as Redpanda Operator
    participant Cluster as Primary Cluster
    participant Shadow as Shadow Cluster
    participant App as Application

    Note over Cluster,Shadow: Steady State (Shadowing Active)
    Cluster->>Shadow: Async cross-region replication<br/>(topics, configs, offsets)
    Shadow-->>Cluster: Lag metrics & status

    Note over User,App: Disaster Detected
    User->>Cluster: Assess situation<br/>(rpk shadow describe)
    User->>Shadow: Verify shadow cluster status<br/>(rpk shadow describe --status)

    Note over User: Decision Point
    alt Topic-level Failover
        User->>Shadow: rpk shadow failover<br/>(specific topics)
    else Cluster-level Failover
        User->>Shadow: rpk shadow failover --all
    end

    rect rgba(255, 107, 107, 0.1)
    Note over Shadow: Failover Process
    Shadow->>Shadow: Convert shadow topics to writable<br/>Stop replication from primary
    Shadow->>Shadow: Update topic states to ACTIVE
    end

    User->>App: Update application config<br/>(point to shadow cluster)
    App->>Shadow: Resume produce/consume<br/>against shadow cluster
    User->>Shadow: Verify application functionality

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~45 minutes

• Navigation restructuring: modules/ROOT/nav.adoc reorganizes major sections with new Disaster Recovery hierarchy; verify all xref paths resolve correctly
• Version consistency: Update from 25.2 to 25.3-beta across multiple files (antora.yml, version tags in content); ensure all references are synchronized
• Cross-reference migrations: Multiple pages update xref paths (e.g., manage:remote-read-replicas.adoc → deploy:redpanda/manual/remote-read-replicas.adoc); validate completeness
• New Shadowing documentation: 6+ new pages for disaster recovery feature with interdependent content; verify internal consistency and completeness of failover workflows
• File reorganization: Topic Recovery and other pages moved/relocated with aliases; confirm old paths have proper redirects via aliases
• Iceberg migration: AWS Glue → Google Cloud BigLake; check all references and examples are consistent

Possibly related PRs

• dr: adds shadowing docs #1381: Adds and modifies Shadowing (disaster-recovery) documentation with overlapping failover and runbook content
• Fix version #1438: Modifies antora.yml version/display_version/prerelease fields and local-antora-playbook.yml branches configuration
• DOC-1197: Auto-Enable Features on First License #1449: Adds beta branch to GitHub workflows build.yml push trigger

Suggested reviewers

• mattschumpert
• micheleRP
• Feediver1

Pre-merge checks and finishing touches

❌ Failed checks (1 warning, 1 inconclusive)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The PR description is incomplete. It uses template placeholders without filling in required information: the Jira ticket URL is unresolved, review deadline is missing, page previews are not provided, and no checkboxes are marked to indicate the type of change.	Complete the description by resolving the Jira ticket reference, providing page preview links for modified/new documentation pages, and marking the appropriate checkbox(es) indicating the type of change (likely 'New feature' or 'Content gap').
Title check	❓ Inconclusive	The title 'Refine properties list' is vague and does not clearly convey the main changes in the PR, which involve significant documentation restructuring including disaster recovery features, Shadowing setup, version bumps, and navigation reorganization.	Use a more specific title that reflects the primary changes, such as 'Add disaster recovery documentation and update version to 25.3' or 'Restructure disaster recovery and navigation with version 25.3 updates'.

✅ 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.

---

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

• X
• Mastodon
• Reddit
• LinkedIn

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