diff --git a/taskchampion/src/server/mod.rs b/taskchampion/src/server/mod.rs
index 21411241c..68b5a713f 100644
--- a/taskchampion/src/server/mod.rs
+++ b/taskchampion/src/server/mod.rs
@@ -1,3 +1,13 @@
+/**
+
+This module defines the client interface to TaskChampion sync servers.
+It defines a [trait](crate::server::Server) for servers, and implements both local and remote servers.
+
+Typical uses of this crate do not interact directly with this module; [`ServerConfig`](crate::ServerConfig) is sufficient.
+However, users who wish to implement their own server interfaces can implement the traits defined here and pass the result to [`Replica`](crate::Replica).
+
+*/
+
 #[cfg(test)]
 pub(crate) mod test;
 
diff --git a/taskchampion/src/storage/mod.rs b/taskchampion/src/storage/mod.rs
index 0932afd3f..fec354ed2 100644
--- a/taskchampion/src/storage/mod.rs
+++ b/taskchampion/src/storage/mod.rs
@@ -1,3 +1,12 @@
+/**
+
+This module defines the backend storage used by [`Replica`](crate::Replica).
+It defines a [trait](crate::storage::Storage) for storage implementations, and provides a default on-disk implementation as well as an in-memory implementation for testing.
+
+Typical uses of this crate do not interact directly with this module; [`StorageConfig`](crate::StorageConfig) is sufficient.
+However, users who wish to implement their own storage backends can implement the traits defined here and pass the result to [`Replica`](crate::Replica).
+
+*/
 use failure::Fallible;
 use std::collections::HashMap;
 use uuid::Uuid;