diff --git a/README.asciidoc b/README.asciidoc
index 90e7e6e34..3f3e96eeb 100644
--- a/README.asciidoc
+++ b/README.asciidoc
@@ -46,6 +46,10 @@ After installing the <<requirements,requirements>>, you have these options:
 * Run `python3 setup.py install` to install qutebrowser, then call
 `qutebrowser`.
 
+NOTE: If you're running qutebrowser from the git repository rather than a
+released version, you should run `scripts/asciidoc2html.py` to generate the
+documentation.
+
 Contributions / Bugs
 --------------------