From 710b2fe0d129a193599ad08efd36fa0fdae41926 Mon Sep 17 00:00:00 2001
From: micheleRP <michele@redpanda.com>
Date: Thu, 19 Mar 2026 20:31:40 -0600
Subject: [PATCH] DOC-1811 Document Cloud Feature User-based throughput quotas

---
 local-antora-playbook.yml                                | 2 +-
 modules/ROOT/nav.adoc                                    | 1 +
 modules/get-started/pages/whats-new-cloud.adoc           | 9 +++++++++
 .../cluster-maintenance/about-throughput-quotas.adoc     | 7 +++++++
 .../pages/cluster-maintenance/manage-throughput.adoc     | 5 ++++-
 5 files changed, 22 insertions(+), 2 deletions(-)
 create mode 100644 modules/manage/pages/cluster-maintenance/about-throughput-quotas.adoc

diff --git a/local-antora-playbook.yml b/local-antora-playbook.yml
index d8d478c82..d8505941d 100644
--- a/local-antora-playbook.yml
+++ b/local-antora-playbook.yml
@@ -15,7 +15,7 @@ content:
   - url: .
     branches: HEAD
   - url: https://github.com/redpanda-data/documentation
-    branches: [main, v/*, shared, site-search]
+    branches: [v-WIP/26.1, v/*, shared, site-search]
   - url: https://github.com/redpanda-data/docs-site
     branches: [main]
     start_paths: [home]
diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc
index 5e4bd59cb..30bec8e7b 100644
--- a/modules/ROOT/nav.adoc
+++ b/modules/ROOT/nav.adoc
@@ -451,6 +451,7 @@
 *** xref:manage:cluster-maintenance/config-cluster.adoc[]
 *** xref:manage:audit-logging.adoc[]
 **** xref:manage:audit-logging/audit-log-samples.adoc[]
+*** xref:manage:cluster-maintenance/about-throughput-quotas.adoc[]
 *** xref:manage:cluster-maintenance/manage-throughput.adoc[]
 *** xref:manage:cluster-maintenance/configure-availability.adoc[]
 ** xref:manage:mountable-topics.adoc[]
diff --git a/modules/get-started/pages/whats-new-cloud.adoc b/modules/get-started/pages/whats-new-cloud.adoc
index 69c095763..4c0b24739 100644
--- a/modules/get-started/pages/whats-new-cloud.adoc
+++ b/modules/get-started/pages/whats-new-cloud.adoc
@@ -6,6 +6,15 @@
 
 This page lists new features added to Redpanda Cloud.
 
+== April 2026
+
+=== User-based throughput quotas
+
+You can now configure throughput quotas based on authenticated user principals (SASL, mTLS, or OIDC) in addition to client IDs. User-based quotas provide more precise control over resource allocation, especially in multi-tenant environments where multiple applications share the same cluster.
+
+* xref:manage:cluster-maintenance/about-throughput-quotas.adoc[About client throughput quotas]
+* xref:manage:cluster-maintenance/manage-throughput.adoc[Manage throughput]
+
 == March 2026
 
 === BYOVPC on AWS: GA
diff --git a/modules/manage/pages/cluster-maintenance/about-throughput-quotas.adoc b/modules/manage/pages/cluster-maintenance/about-throughput-quotas.adoc
new file mode 100644
index 000000000..6668bf984
--- /dev/null
+++ b/modules/manage/pages/cluster-maintenance/about-throughput-quotas.adoc
@@ -0,0 +1,7 @@
+= About Client Throughput Quotas
+:description: Understand how Redpanda's user-based and client ID-based throughput quotas work, including entity hierarchy, precedence rules, and quota tracking behavior.
+:learning-objective-1: Describe the difference between user-based and client ID-based quotas
+:learning-objective-2: Determine which quota type to use for your use case
+:learning-objective-3: Explain quota precedence rules and how Redpanda tracks quota usage
+
+include::ROOT:manage:cluster-maintenance/about-throughput-quotas.adoc[tag=single-source]
diff --git a/modules/manage/pages/cluster-maintenance/manage-throughput.adoc b/modules/manage/pages/cluster-maintenance/manage-throughput.adoc
index e76b4b94f..f572f6378 100644
--- a/modules/manage/pages/cluster-maintenance/manage-throughput.adoc
+++ b/modules/manage/pages/cluster-maintenance/manage-throughput.adoc
@@ -1,4 +1,7 @@
 = Manage Throughput
-:description: Manage the throughput of Kafka traffic with configurable properties.
+:description: Configure broker-wide and client-specific throughput quotas to prevent resource exhaustion and noisy-neighbor issues.
+:learning-objective-1: Set user-based throughput quotas
+:learning-objective-2: Set client ID-based quotas
+:learning-objective-3: Monitor quota usage and throttling behavior
 
 include::ROOT:manage:cluster-maintenance/manage-throughput.adoc[tag=single-source]
\ No newline at end of file