From d3dc7b95131de6d02d879161888778437dedd1b9 Mon Sep 17 00:00:00 2001
From: Cory Benfield <lukasa@apple.com>
Date: Mon, 18 Nov 2024 11:29:23 +0000
Subject: [PATCH] Docs clarification

---
 Sources/NIOCore/EventLoopFuture+AssumeIsolated.swift | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/Sources/NIOCore/EventLoopFuture+AssumeIsolated.swift b/Sources/NIOCore/EventLoopFuture+AssumeIsolated.swift
index 6b9ae952d5..4748ef320d 100644
--- a/Sources/NIOCore/EventLoopFuture+AssumeIsolated.swift
+++ b/Sources/NIOCore/EventLoopFuture+AssumeIsolated.swift
@@ -147,8 +147,8 @@ extension EventLoop {
     /// Assumes the calling context is isolated to the event loop.
     ///
     /// This version of ``EventLoop/assumeIsolated()`` omits the runtime
-    /// isolation check in release builds. It retains it in debug mode to
-    /// ensure correctness.
+    /// isolation check in release builds and doesn't prevent you using it
+    /// from using it in async contexts.
     @inlinable
     public func assumeIsolatedUnsafeUnchecked() -> NIOIsolatedEventLoop {
         self.assertInEventLoop()
@@ -524,8 +524,8 @@ extension EventLoopFuture {
     /// if that invariant fails to be met.
     ///
     /// This is an unsafe version of ``EventLoopFuture/assumeIsolated()`` which
-    /// omits the runtime check in release builds. This improves performance, but
-    /// should only be used sparingly.
+    /// omits the runtime check in release builds and doesn't prevent you using it
+    /// from using it in async contexts.
     @inlinable
     @available(*, noasync)
     public func assumeIsolatedUnsafeUnchecked() -> Isolated {
@@ -616,8 +616,8 @@ extension EventLoopPromise {
     /// if that invariant fails to be met.
     ///
     /// This is an unsafe version of ``EventLoopPromise/assumeIsolated()`` which
-    /// omits the runtime check in release builds. This improves performance, but
-    /// should only be used sparingly.
+    /// omits the runtime check in release builds and doesn't prevent you using it
+    /// from using it in async contexts.
     @inlinable
     public func assumeIsolatedUnsafeUnchecked() -> Isolated {
         self.futureResult.eventLoop.assertInEventLoop()