3 files changed, 11 insertions, 8 deletions

diff --git a/embassy-futures/src/join.rs b/embassy-futures/src/join.rs
index 39a78ccd3..7600d4b8a 100644
--- a/embassy-futures/src/join.rs
+++ b/embassy-futures/src/join.rs
@@ -1,3 +1,5 @@
+//! Wait for multiple futures to complete.
+
 use core::future::Future;
 use core::pin::Pin;
 use core::task::{Context, Poll};
@@ -131,7 +133,7 @@ generate! {
 ///
 /// let a = async { 1 };
 /// let b = async { 2 };
-/// let pair = embassy_futures::join(a, b).await;
+/// let pair = embassy_futures::join::join(a, b).await;
 ///
 /// assert_eq!(pair, (1, 2));
 /// # });
@@ -160,7 +162,7 @@ where
 /// let a = async { 1 };
 /// let b = async { 2 };
 /// let c = async { 3 };
-/// let res = embassy_futures::join3(a, b, c).await;
+/// let res = embassy_futures::join::join3(a, b, c).await;
 ///
 /// assert_eq!(res, (1, 2, 3));
 /// # });
@@ -191,7 +193,7 @@ where
 /// let b = async { 2 };
 /// let c = async { 3 };
 /// let d = async { 4 };
-/// let res = embassy_futures::join4(a, b, c, d).await;
+/// let res = embassy_futures::join::join4(a, b, c, d).await;
 ///
 /// assert_eq!(res, (1, 2, 3, 4));
 /// # });
@@ -229,7 +231,7 @@ where
 /// let c = async { 3 };
 /// let d = async { 4 };
 /// let e = async { 5 };
-/// let res = embassy_futures::join5(a, b, c, d, e).await;
+/// let res = embassy_futures::join::join5(a, b, c, d, e).await;
 ///
 /// assert_eq!(res, (1, 2, 3, 4, 5));
 /// # });
diff --git a/embassy-futures/src/lib.rs b/embassy-futures/src/lib.rs
index ea135b3ab..8c769bdfc 100644
--- a/embassy-futures/src/lib.rs
+++ b/embassy-futures/src/lib.rs
@@ -6,11 +6,10 @@
 pub(crate) mod fmt;
 
 mod block_on;
-mod join;
-mod select;
 mod yield_now;
 
+pub mod join;
+pub mod select;
+
 pub use block_on::*;
-pub use join::*;
-pub use select::*;
 pub use yield_now::*;
diff --git a/embassy-futures/src/select.rs b/embassy-futures/src/select.rs
index c0dd7ecd3..97a81a86d 100644
--- a/embassy-futures/src/select.rs
+++ b/embassy-futures/src/select.rs
@@ -1,3 +1,5 @@
+//! Wait for the first of several futures to complete.
+
 use core::future::Future;
 use core::pin::Pin;
 use core::task::{Context, Poll};