diff --git a/embassy-stm32/src/lib.rs b/embassy-stm32/src/lib.rs
index 45a2ab63e..18871e83b 100644
--- a/embassy-stm32/src/lib.rs
+++ b/embassy-stm32/src/lib.rs
@@ -1,5 +1,6 @@
 #![cfg_attr(not(test), no_std)]
 #![allow(async_fn_in_trait)]
+#![doc = include_str!("../README.md")]
 #![warn(missing_docs)]
 
 //! ## Feature flags