diff --git a/README.md b/README.md
new file mode 100644
index 0000000..653175f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,20 @@
+zblog
+=====
+
+This is the third version of the zero-knowledge.org blog. This is generated with
+[hugo](http://gohugo.io/).
+
+how to use
+----------
+
+Either start a small server which refreshes the pages on change with
+
+```
+hugo server --watch --verbose --buildDrafts
+```
+
+or generate everything with
+
+```
+hugo
+```