Doc-1601: Specify cluster UUID to restore with Whole Cluster Recovery

[Feediver1]

Description

Resolves https://redpandadata.atlassian.net/browse/DOC-1601
Work in progress

Review deadline:

Page previews

Checks

• [x ] 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	2048b13
🔍 Latest deploy log	https://app.netlify.com/projects/redpanda-docs-preview/deploys/693bd72af1b0f1ba614f1831
😎 Deploy Preview	https://deploy-preview-1513--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]

📝 Walkthrough

Walkthrough

This pull request adds comprehensive documentation to the Whole Cluster Restore section, covering behavior when multiple Redpanda clusters share the same object storage bucket. The changes explain the role of cluster UUIDs in manifest selection, provide naming conventions and examples for disambiguating clusters using cloud_storage_cluster_name, document multi-cluster sharing scenarios, and expand troubleshooting guidance with Admin API recovery override via cluster_uuid_override.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

• Documentation-only change affecting a single .adoc file
• No code logic, configuration, or structural changes
• Review should focus on:
  • Accuracy of cluster UUID and manifest selection explanations
  • Correctness of cloud_storage_cluster_name naming rules (character limits and allowed characters)
  • Validity of Admin API examples and recovery override syntax
  • Consistency and clarity of multi-cluster bucket layout examples with actual product behavior

Suggested reviewers

• micheleRP
• asimms41

Pre-merge checks and finishing touches

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Description check	❓ Inconclusive	The PR description follows the required template structure with JIRA issue link, page previews section, and checklist, but lacks critical details.	Complete the 'Work in progress' note with actual page preview links once Netlify generates them, and provide more context about what was changed and why.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and specifically describes the main documentation change: adding documentation for specifying cluster UUID in Whole Cluster Recovery.
Linked Issues check	✅ Passed	The PR documentation changes directly address DOC-1601's objective to document the cluster UUID specification feature for Whole Cluster Recovery, including usage scenarios and configuration details.
Out of Scope Changes check	✅ Passed	All changes are documentation-focused and directly related to the objective of documenting cluster UUID specification in Whole Cluster Recovery, with no unrelated modifications.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch DOC-1601

---

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