diff --git a/assets/README.md b/assets/README.md
new file mode 100644
index 000000000..b22d645dc
--- /dev/null
+++ b/assets/README.md
@@ -0,0 +1,13 @@
+# Assets loaded in with IPFS
+
+## Generating docs
+
+Do not edit the .go files directly.
+
+Instead, edit the source files and use `go2doc` from within the
+assets directory:
+
+```
+go get github.com/whyrusleeping/doc2go
+go generate
+```