diff --git a/src/plan.rs b/src/plan.rs
index 168f788c0..f07bf913b 100644
--- a/src/plan.rs
+++ b/src/plan.rs
@@ -1,4 +1,7 @@
-//! The `plan` crate provides functionality for creating spending plans.
+//! A domain-specific language for payment plans. Users create Plan objects that
+//! are given to an interpreter. The interpreter listens for `Witness` events,
+//! which it uses to reduce the payment plan. When the plan is reduced to a
+//! `Payment`, the payment is executed.
 
 use signature::PublicKey;
 use chrono::prelude::*;