From 0eef0601a1eb1d23dfed7b82bbaae0f87a89f879 Mon Sep 17 00:00:00 2001
From: Yuki Okushi <huyuumi.dev@gmail.com>
Date: Sun, 1 Feb 2026 22:10:47 +0900
Subject: [PATCH] docs(files): refine docs of `read_mode_threshold` (#3897)

---
 actix-files/src/files.rs | 8 ++++----
 actix-files/src/named.rs | 8 ++++----
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/actix-files/src/files.rs b/actix-files/src/files.rs
index 3491f59e2..afc852a18 100644
--- a/actix-files/src/files.rs
+++ b/actix-files/src/files.rs
@@ -220,11 +220,11 @@ impl Files {
 
     /// Sets the size threshold that determines file read mode (sync/async).
     ///
-    /// When a file is smaller than the threshold (bytes), the reader will switch from synchronous
-    /// (blocking) file-reads to async reads to avoid blocking the main-thread when processing large
-    /// files.
+    /// When a file is smaller than the threshold (bytes), the reader will use synchronous
+    /// (blocking) file reads. For larger files, it switches to async reads to avoid blocking the
+    /// main thread.
     ///
-    /// Tweaking this value according to your expected usage may lead to signifiant performance
+    /// Tweaking this value according to your expected usage may lead to significant performance
     /// gains (or losses in other handlers, if `size` is too high).
     ///
     /// When the `experimental-io-uring` crate feature is enabled, file reads are always async.
diff --git a/actix-files/src/named.rs b/actix-files/src/named.rs
index 23aa10d5c..7ff66e74d 100644
--- a/actix-files/src/named.rs
+++ b/actix-files/src/named.rs
@@ -357,11 +357,11 @@ impl NamedFile {
 
     /// Sets the size threshold that determines file read mode (sync/async).
     ///
-    /// When a file is smaller than the threshold (bytes), the reader will switch from synchronous
-    /// (blocking) file-reads to async reads to avoid blocking the main-thread when processing large
-    /// files.
+    /// When a file is smaller than the threshold (bytes), the reader will use synchronous
+    /// (blocking) file reads. For larger files, it switches to async reads to avoid blocking the
+    /// main thread.
     ///
-    /// Tweaking this value according to your expected usage may lead to signifiant performance
+    /// Tweaking this value according to your expected usage may lead to significant performance
     /// gains (or losses in other handlers, if `size` is too high).
     ///
     /// When the `experimental-io-uring` crate feature is enabled, file reads are always async.