diff --git a/futures-util/src/stream/stream/mod.rs b/futures-util/src/stream/stream/mod.rs
index 413d9159a..945cf5189 100644
--- a/futures-util/src/stream/stream/mod.rs
+++ b/futures-util/src/stream/stream/mod.rs
@@ -337,6 +337,9 @@ pub trait StreamExt: Stream {
     /// wrapped version of it, similar to the existing `map` methods in the
     /// standard library.
     ///
+    /// See [`StreamExt::then`](Self::then) if you want to use a closure that
+    /// returns a future instead of a value.
+    ///
     /// # Examples
     ///
     /// ```
@@ -481,6 +484,9 @@ pub trait StreamExt: Stream {
     /// Note that this function consumes the stream passed into it and returns a
     /// wrapped version of it.
     ///
+    /// See [`StreamExt::map`](Self::map) if you want to use a closure that
+    /// returns a value instead of a future.
+    ///
     /// # Examples
     ///
     /// ```