diff --git a/library/std/src/io/mod.rs b/library/std/src/io/mod.rs
index aa34d4be192..d4f8c3123b2 100644
--- a/library/std/src/io/mod.rs
+++ b/library/std/src/io/mod.rs
@@ -1392,10 +1392,10 @@ pub trait Write {
     /// written, and a write which would otherwise block can be indicated through
     /// an [`Err`] variant.
     ///
-    /// If the return value is [`Ok(n)`] then it must be guaranteed that `n <=
-    /// buf.len()`. Unless `input` is empty, this function shouldn’t return `0`
-    /// since caller may interpret that as an error (the default implementation
-    /// of [`Write::write_all`] does exactly that).  To indicate lack of space
+    /// If this method consumed `n > 0` bytes of `buf` it must return [`Ok(n)`].
+    /// If the return value is `Ok(n)` it must hold than `n <= buf.len()`.
+    /// Unless `input` is empty, this function shouldn’t return `Ok(0)` since
+    /// caller may interpret that as an error.  To indicate lack of space
     /// function should return [`ErrorKind::StorageFull`] error instead.
     ///
     /// # Errors