diff --git a/README.md b/README.md
index da657ff1..74b17a1a 100644
--- a/README.md
+++ b/README.md
@@ -62,6 +62,18 @@ You can quickly setup a redis by either installing it from your system package m
 `docker run --name github-bridge-redis -p 6379:6379 -d redis`
 
 in Docker.
+
+## Documentation
+
+Documentation can be found on [GitHub Pages](https://matrix-org.github.io/matrix-appservice-irc).
+
+You can build the documentaion yourself by:
+```sh
+# cargo install mdbook
+mdbook build
+sensible-browser book/index.html
+```
+
 ## Contact
 
 TODO...
\ No newline at end of file