\ No newline at end of file
diff --git a/taoensso.nippy.benchmarks.html b/taoensso.nippy.benchmarks.html
index f811dc9..d019cf9 100644
--- a/taoensso.nippy.benchmarks.html
+++ b/taoensso.nippy.benchmarks.html
@@ -1,2 +1,2 @@
-taoensso.nippy.benchmarks documentation
\ No newline at end of file
diff --git a/taoensso.nippy.crypto.html b/taoensso.nippy.crypto.html
new file mode 100644
index 0000000..a6eb284
--- /dev/null
+++ b/taoensso.nippy.crypto.html
@@ -0,0 +1,28 @@
+
+taoensso.nippy.crypto documentation
Alpha - subject to change.
+Simple no-nonsense crypto with reasonable defaults. Because your Clojure data
+deserves some privacy.
aes128-cached
USE CASE: You want only a small, finite number of passwords (e.g. a limited
+ number of staff/admins, or you'll be using a single password to
+ encrypt many items).
+
+IMPLEMENTATION: Uses a _very_ expensive (but cached) key hash, and no salt.
+
+PROS: Great amortized encryption/decryption speed. Expensive key hash makes
+ attacking any particular key very difficult.
+CONS: Using a small number of keys for many encrypted items means that if any
+ key _is_ somehow compromised, _all_ items encrypted with that key are
+ compromised.
+
+Faster than `aes128-salted`, and harder to attack any particular key - but
+increased danger if a key is somehow compromised.
aes128-salted
USE CASE: You want more than a small, finite number of passwords (e.g. each
+ item encrypted will use a unique user-provided password).
+
+IMPLEMENTATION: Uses a relatively cheap key hash, but automatically salts
+ every key.
+
+PROS: Each key is independent so would need to be attacked independently.
+CONS: Key caching impossible, so there's an inherent trade-off between
+ encryption/decryption speed and the difficulty of attacking any
+ particular key.
+
+Slower than `aes128-cached`, and easier to attack any particular key.
\ No newline at end of file
diff --git a/taoensso.nippy.html b/taoensso.nippy.html
index 63dd9a4..777f609 100644
--- a/taoensso.nippy.html
+++ b/taoensso.nippy.html
@@ -1,13 +1,13 @@
-taoensso.nippy documentation
\ No newline at end of file
diff --git a/taoensso.nippy.utils.html b/taoensso.nippy.utils.html
index fab4bbb..65af72a 100644
--- a/taoensso.nippy.utils.html
+++ b/taoensso.nippy.utils.html
@@ -1,7 +1,8 @@
-taoensso.nippy.utils documentation