diff --git a/src/extractors.rs b/src/extractors.rs
index a7adb09..576028f 100644
--- a/src/extractors.rs
+++ b/src/extractors.rs
@@ -1,3 +1,5 @@
+//! Axum extractors for htmx headers.
+
 use axum::{extract::FromRequestParts, http::request::Parts};
 
 use crate::{
diff --git a/src/headers.rs b/src/headers.rs
index e547141..34c5a7a 100644
--- a/src/headers.rs
+++ b/src/headers.rs
@@ -1,3 +1,5 @@
+//! HTTP headers used by htmx.
+
 /// Indicates that the request is via an element using `hx-boost` attribute.
 ///
 /// See <https://htmx.org/attributes/hx-boost/> for more information.
diff --git a/src/lib.rs b/src/lib.rs
index be3313e..9ea0b88 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -1,3 +1,4 @@
+#![doc = include_str!("../README.md")]
 #![forbid(unsafe_code)]
 pub mod extractors;
 pub mod headers;