From 74af1f0b9dff7b3d14d5408f286700c0357783e1 Mon Sep 17 00:00:00 2001
From: Joe Thomas <hpesoj@amazon.com>
Date: Fri, 12 Sep 2025 18:37:58 -0500
Subject: [PATCH] docs: Update num_alive_tasks docs

---
 tokio/src/runtime/metrics/runtime.rs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/tokio/src/runtime/metrics/runtime.rs b/tokio/src/runtime/metrics/runtime.rs
index 6302457b8d5..4638dc3b1db 100644
--- a/tokio/src/runtime/metrics/runtime.rs
+++ b/tokio/src/runtime/metrics/runtime.rs
@@ -54,6 +54,10 @@ impl RuntimeMetrics {
     /// This counter increases when a task is spawned and decreases when a
     /// task exits.
     ///
+    /// Note: When using the multi-threaded runtime this number may not
+    /// not have strong consistency i.e. no tasks may be running but the metric
+    /// reports otherwise.
+    ///
     /// # Examples
     ///
     /// ```