diff --git a/crates/futures/src/lib.rs b/crates/futures/src/lib.rs
index 2b6278f6..e8a6103c 100644
--- a/crates/futures/src/lib.rs
+++ b/crates/futures/src/lib.rs
@@ -119,9 +119,11 @@ cfg_if! {
         /// Contains a Futures 0.3 implementation of this crate.
         pub mod futures_0_3;
 
+        /// Contains stable version of the crate
         pub mod stable;
         pub use stable::*;
      } else {
+        /// Contains stable version of the crate
         pub mod stable;
         pub use stable::*;
      }
diff --git a/crates/futures/src/polyfill.rs b/crates/futures/src/polyfill.rs
index 9951c85f..8a2c3424 100644
--- a/crates/futures/src/polyfill.rs
+++ b/crates/futures/src/polyfill.rs
@@ -1,7 +1,7 @@
-/*
- * The polyfill was kindly borrowed from https://github.com/tc39/proposal-atomics-wait-async
- * and ported to Rust
- */
+//!
+//! The polyfill was kindly borrowed from https://github.com/tc39/proposal-atomics-wait-async
+//! and ported to Rust
+//!
 
 /* This Source Code Form is subject to the terms of the Mozilla Public
  * License, v. 2.0. If a copy of the MPL was not distributed with this