diff --git a/src/lib.rs b/src/lib.rs
index de692a42..7e8a7000 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -5,8 +5,11 @@
     rustc::internal
 )]
 #![deny(missing_docs)]
-
-//! A crate to run the Rust compiler (or other binaries) and test their command line output.
+#![cfg_attr(doc, doc = include_str!("../README.md"))]
+#![cfg_attr(
+    not(doc),
+    doc = "A crate to run the Rust compiler (or other binaries) and test their command line output."
+)]
 
 use build_manager::BuildManager;
 pub use color_eyre;