diff --git a/README.rst b/README.rst
index 9d998fc..449c06b 100644
--- a/README.rst
+++ b/README.rst
@@ -30,3 +30,15 @@ Easiest installation ever
   pip3 install --user git+https://github.com/moble/spherical_functions.git
   python3 setup.py install --user
 
+
+  
+Documentation
+=============
+
+Documentation of QPMS is a work in progress. Most of the newer code
+is documented using doxygen comments. To build the documentation, just run::
+
+  doxygen
+
+in the root directory; the documentation will then be found in 
+``docs/index.html``.