Merge pull request #697 from async-rs/core-docs

Document the core feature

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))]