diff --git a/Cargo.toml b/Cargo.toml
index 391befd..4b7aad0 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -28,4 +28,8 @@ doctest = false
 
 [profile.release]
 codegen-units = 1
-lto = true
\ No newline at end of file
+lto = true
+
+[package.metadata.docs.rs]
+# build docs for all features
+all-features = true
diff --git a/src/lib.rs b/src/lib.rs
index a91fe07..1030890 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -1,3 +1,4 @@
+#![doc = include_str!("../README.md")]
 #![no_std]
 
 mod dht;