diff --git a/src/lib.rs b/src/lib.rs
index 05073a2..a6a8f31 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -220,6 +220,16 @@
 //! default-features = false
 //! features = ["std"]
 //! ```
+//! 
+//! And to use async-std on `no_std` targets that only support `alloc` only
+//! enable the `alloc` Cargo feature:
+//!
+//! ```toml
+//! [dependencies.async-std]
+//! version = "1.5.0"
+//! default-features = false
+//! features = ["alloc"]
+//! ```
 
 #![cfg_attr(not(feature = "std"), no_std)]
 #![cfg_attr(feature = "docs", feature(doc_cfg))]