add docs for the 'server' and 'storage' modules

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;
 

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;