diff --git a/library/core/src/fmt/mod.rs b/library/core/src/fmt/mod.rs
index 485ad4aee19..45c2b6a6a0f 100644
--- a/library/core/src/fmt/mod.rs
+++ b/library/core/src/fmt/mod.rs
@@ -1626,6 +1626,11 @@ pub fn write_str(&mut self, data: &str) -> Result {
         self.buf.write_str(data)
     }
 
+    /// Glue for usage of the [`write!`] macro with implementors of this trait.
+    ///
+    /// This method should generally not be invoked manually, but rather through
+    /// the [`write!`] macro itself.
+    ///
     /// Writes some formatted information into this instance.
     ///
     /// # Examples