diff --git a/README.rst b/README.rst
index 8ce13852b85f30fa491cbc17f886ae2f7db831ba..326c0869dec6d7568198d361b779619705948868 100644
--- a/README.rst
+++ b/README.rst
@@ -4,6 +4,9 @@ Olm
 An implementation of the cryptographic ratchet described by
 https://github.com/trevp/axolotl/wiki, written in C++11 and exposed as a C API
 
+The specification of the Olm ratchet can be found in docs/olm.rst or
+https://matrix.org/docs/spec/olm.html
+
 Building
 --------