DOC-1811 Document Cloud Feature User-based throughput quotas

[micheleRP]

Description

DO NOT MERGE UNTIL 26.1 + revert playbook

This PR updates doc to support the new user-based throughput quotas feature in Redpanda Cloud. SIngle sourcing done in redpanda-data/docs#1596

• Added a new page, about-throughput-quotas.adoc, to single source user-based and client ID-based throughput quotas, their hierarchy, precedence, and quota tracking behavior.
• Announced the availability of user-based throughput quotas in the April 2026 section of whats-new-cloud.adoc.
• Added about-throughput-quotas.adoc to the navigation in nav.adoc.
• Expanded the description and learning objectives for the manage-throughput.adoc page to cover user-based quotas, client ID-based quotas, and monitoring.

Antora Playbook Update: REVERT BEFORE MERGING

• Updated the Antora playbook to track the new v-WIP/26.1 branch for preview docs

Resolves https://redpandadata.atlassian.net/browse/DOC-1811?search_id=7159cbcc-d80d-45ac-99c8-1f79b6177251
Review deadline: March 27

Page previews

What's New
About Client Throughput Quotas
Manage Throughput

Checks

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

[coderabbitai]

Important

Review skipped

Auto incremental reviews are disabled on this repository.

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.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 3d630cbe-cd6d-4bc0-accc-cc7c4b057ee0

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

Use the checkbox below for a quick retry:

• 🔍 Trigger review

📝 Walkthrough

Walkthrough

This pull request updates the documentation configuration and content to introduce user-based throughput quotas functionality. The Antora playbook is switched from the main branch to the v-WIP/26.1 feature branch for the documentation source. A new documentation page about throughput quotas is created, navigation is updated to link to it, the "What's New in Redpanda Cloud" page is augmented with April 2026 changes describing user-based quotas, and metadata on the manage-throughput page is updated with new learning objectives.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• DOC-1586 single source Manage Throughput in cloud docs #388: Modifies both modules/ROOT/nav.adoc and modules/manage/pages/cluster-maintenance/manage-throughput.adoc, plus updates the same Antora playbook branch configuration.
• DOC-1939 add schema validation topic in cloud docs #495: Modifies the same Antora playbook branch selection and adds new documentation pages with navigation entries.
• Improve MCP devex #478: Updates the Antora playbook's content source branches and makes corresponding documentation navigation and content changes.

Suggested reviewers

• r-vasquez
• kbatuigas
• Feediver1

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly identifies the main change: documenting the new user-based throughput quotas feature for Redpanda Cloud, which aligns with all the modifications in the changeset.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description check	✅ Passed	The pull request description is comprehensive and well-structured, following the template with all required sections completed: Issue reference, review deadline, page previews, and appropriate checkbox selections.

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

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch DOC-1811-Document-Cloud-Feature-User-based-throughput-quotas

---

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

[netlify]

✅ Deploy Preview for rp-cloud ready!

Name	Link
🔨 Latest commit	2cda8af
🔍 Latest deploy log	https://app.netlify.com/projects/rp-cloud/deploys/69cbd123de4f500008fc9284
😎 Deploy Preview	https://deploy-preview-534--rp-cloud.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.

[micheleRP]

@pgellert, @mattschumpert please let me know if there are any changes to this for Cloud!

[coderabbitai]

🧹 Nitpick comments (1)

local-antora-playbook.yml (1)

18-18: Add an explicit inline “revert before merge” marker at Line 18.

This change is valid for preview, but adding an inline comment reduces the chance of accidentally merging a WIP branch pin.

Based on learnings: local Antora playbook branch overrides are used for cross-repo single-sourcing previews and are reverted before merge.

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@local-antora-playbook.yml` at line 18, The branches entry currently pins a
WIP branch ("v-WIP/26.1") which must be clearly marked for removal before
merging; add an inline comment marker adjacent to the branches list (e.g.,
"REVERT-BEFORE-MERGE: v-WIP/26.1") so reviewers and CI can spot and remove the
WIP pin prior to merge, updating the branches line/object that contains
"v-WIP/26.1" to include that explicit revert-before-merge marker.

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@local-antora-playbook.yml`:
- Line 18: The branches entry currently pins a WIP branch ("v-WIP/26.1") which
must be clearly marked for removal before merging; add an inline comment marker
adjacent to the branches list (e.g., "REVERT-BEFORE-MERGE: v-WIP/26.1") so
reviewers and CI can spot and remove the WIP pin prior to merge, updating the
branches line/object that contains "v-WIP/26.1" to include that explicit
revert-before-merge marker.

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ba3fcdbf-0daa-48e1-8bbc-56e20dc2c3dc

📥 Commits

Reviewing files that changed from the base of the PR and between d122be8 and 710b2fe.

📒 Files selected for processing (5)

• local-antora-playbook.yml
• modules/ROOT/nav.adoc
• modules/get-started/pages/whats-new-cloud.adoc
• modules/manage/pages/cluster-maintenance/about-throughput-quotas.adoc
• modules/manage/pages/cluster-maintenance/manage-throughput.adoc

[pgellert]

lgtm

please let me know if there are any changes to this for Cloud!

No Cloud-only changes needed for user quotas 👍

[Feediver1]

lgtm