diff --git a/README.md b/README.md
index d8845f9..9dfb681 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,6 @@
-# eip3074-instructions
+# EIP3074 instructions
+
+[EIP-3074](https://eips.ethereum.org/EIPS/eip-3074) `AUTH` and `AUTHCALL` instructions.
+
+The implementation is located in the [instructions] module. The custom instruction
+context required for `AUTH` and `AUTHCALL` is located in the [context] module.
diff --git a/src/lib.rs b/src/lib.rs
index 217ab43..5fe2c8c 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -1,12 +1,4 @@
-//! # AlphaNet instructions
-//!
-//! Collection of custom opcodes for AlphaNet and related functionality.
-//!
-//! This currently implements the following EIPs:
-//! - [EIP-3074](https://eips.ethereum.org/EIPS/eip-3074): `AUTH` and `AUTHCALL` instructions. The
-//!   implementation is located in the [instructions] module. The custom instruction context required for
-//!   `AUTH` and `AUTHCALL` is located in the [context] module.
-
+#![doc = include_str!("../README.md")]
 #![cfg_attr(not(test), warn(unused_crate_dependencies))]
 
 use reth::revm::interpreter::opcode::BoxedInstruction;