diff --git a/README.md b/README.md
index 444a59b1..62eff3ca 100644
--- a/README.md
+++ b/README.md
@@ -59,6 +59,8 @@ according to your needs (replace app4triqs in the following by the name of your
 * In the `python/app4triqs` subdirectory add your Python source files.
   Be sure to remove the `app4triqs_module_desc.py` file unless you want to generate a Python module from your C++ source code.
 * In the `test/python` subdirectory adjust the example test `Basic.py` or add your own tests.
+* Adjust any documentation examples given as `*.rst` files in the doc directory.
+* Adjust the sphinx configuration in `doc/conf.py.in` as necessary.
 * The build and install process is identical to the one outline [here](https://triqs.github.io/app4triqs/unstable/install.html).
 
 ### Optional ###