diff --git a/README.md b/README.md
index 8b85ab4..49e2471 100644
--- a/README.md
+++ b/README.md
@@ -63,7 +63,8 @@ as only one process is writing the to file system or database at a time.
 The main implementation detail here is `approveDomains(options, certs, cb)` for new domain certificates
 and potentially `agreeToTerms(opts, cb)` for new accounts.
 
-The master takes **the same arguments** as `node-letsencrypt`, plus a few extra:
+The master takes **the same arguments** as `node-letsencrypt` (`challenge`, `store`, etc),
+plus a few extra (`approveDomains`... okay, just one extra):
 
 `master.js`:
 ```javascript
diff --git a/examples/README.md b/examples/README.md
new file mode 100644
index 0000000..4c8b22c
--- /dev/null
+++ b/examples/README.md
@@ -0,0 +1,12 @@
+letsencrypt cluster examples
+-------------------
+
+First you need to change the email address in `examples/worker.js`.
+
+Then you can run the example like so:
+
+```
+node examples/serve.js
+```
+
+That will put certificates in `~/letsencrypt.test` by default.