diff --git a/35/ops.html b/35/ops.html
index 44ade2529..414507773 100644
--- a/35/ops.html
+++ b/35/ops.html
@@ -1899,7 +1899,7 @@ <h5 class="anchor-heading"><a id="kraft_quorum_monitoring" class="anchor-link"><
   </tr>
   <tr>
     <td>Average Poll Idle Ratio</td>
-    <td>The average fraction of time the client's poll() is idle as opposed to waiting for the user code to process records.</td>
+    <td>The ratio of time the Raft IO thread is idle as opposed to doing work (e.g. handling requests or replicating from the leader)</td>
     <td>kafka.server:type=raft-metrics,name=poll-idle-ratio-avg</td>
   </tr>
   </tbody>
diff --git a/36/ops.html b/36/ops.html
index 133b48ee1..5fccb205d 100644
--- a/36/ops.html
+++ b/36/ops.html
@@ -1987,7 +1987,7 @@ <h5 class="anchor-heading"><a id="kraft_quorum_monitoring" class="anchor-link"><
   </tr>
   <tr>
     <td>Average Poll Idle Ratio</td>
-    <td>The average fraction of time the client's poll() is idle as opposed to waiting for the user code to process records.</td>
+    <td>The ratio of time the Raft IO thread is idle as opposed to doing work (e.g. handling requests or replicating from the leader)</td>
     <td>kafka.server:type=raft-metrics,name=poll-idle-ratio-avg</td>
   </tr>
   <tr>
diff --git a/37/ops.html b/37/ops.html
index 73a192a18..d82483033 100644
--- a/37/ops.html
+++ b/37/ops.html
@@ -2053,7 +2053,7 @@ <h5 class="anchor-heading"><a id="kraft_quorum_monitoring" class="anchor-link"><
   </tr>
   <tr>
     <td>Average Poll Idle Ratio</td>
-    <td>The average fraction of time the client's poll() is idle as opposed to waiting for the user code to process records.</td>
+    <td>The ratio of time the Raft IO thread is idle as opposed to doing work (e.g. handling requests or replicating from the leader)</td>
     <td>kafka.server:type=raft-metrics,name=poll-idle-ratio-avg</td>
   </tr>
   <tr>
diff --git a/38/ops.html b/38/ops.html
index 27666303c..d00fc6a37 100644
--- a/38/ops.html
+++ b/38/ops.html
@@ -2011,7 +2011,7 @@ <h5 class="anchor-heading"><a id="kraft_quorum_monitoring" class="anchor-link"><
   </tr>
   <tr>
     <td>Average Poll Idle Ratio</td>
-    <td>The average fraction of time the client's poll() is idle as opposed to waiting for the user code to process records.</td>
+    <td>The ratio of time the Raft IO thread is idle as opposed to doing work (e.g. handling requests or replicating from the leader)</td>
     <td>kafka.server:type=raft-metrics,name=poll-idle-ratio-avg</td>
   </tr>
   <tr>
diff --git a/39/ops.html b/39/ops.html
index 646d1c3ca..d8eb47234 100644
--- a/39/ops.html
+++ b/39/ops.html
@@ -2035,7 +2035,7 @@ <h5 class="anchor-heading"><a id="kraft_quorum_monitoring" class="anchor-link"><
   </tr>
   <tr>
     <td>Average Poll Idle Ratio</td>
-    <td>The average fraction of time the client's poll() is idle as opposed to waiting for the user code to process records.</td>
+    <td>The ratio of time the Raft IO thread is idle as opposed to doing work (e.g. handling requests or replicating from the leader)</td>
     <td>kafka.server:type=raft-metrics,name=poll-idle-ratio-avg</td>
   </tr>
   <tr>
diff --git a/40/ops.html b/40/ops.html
index 5a60a4cde..4d5803935 100644
--- a/40/ops.html
+++ b/40/ops.html
@@ -2118,7 +2118,7 @@ <h5 class="anchor-heading"><a id="kraft_quorum_monitoring" class="anchor-link"><
   </tr>
   <tr>
     <td>Average Poll Idle Ratio</td>
-    <td>The average fraction of time the client's poll() is idle as opposed to waiting for the user code to process records.</td>
+    <td>The ratio of time the Raft IO thread is idle as opposed to doing work (e.g. handling requests or replicating from the leader)</td>
     <td>kafka.server:type=raft-metrics</td>
   </tr>
   <tr>