diff --git a/README.md b/README.md
index 9346dfe..e3a8a5e 100644
--- a/README.md
+++ b/README.md
@@ -319,3 +319,12 @@ Options:
 ```
 
 
+## test
+
+The pytests are in `./test` and use a moker to provide a json response instead
+of having to call the patroni API.
+
+A vagrant file is available to create a icinga / opm / grafana stack and
+install check_patroni. You can then add a server to the supervision and
+watch the graphs in grafana. It's in `./test/vagrant`.
+
diff --git a/doc/make_readme.sh b/doc/make_readme.sh
index a388f77..5c9d501 100755
--- a/doc/make_readme.sh
+++ b/doc/make_readme.sh
@@ -107,3 +107,16 @@ helpme node_tl_has_changed
 cat << _EOF_ >> $README
 
 _EOF_
+
+cat << '_EOF_' >> $README
+## test
+
+The pytests are in `./test` and use a moker to provide a json response instead
+of having to call the patroni API.
+
+A vagrant file is available to create a icinga / opm / grafana stack and
+install check_patroni. You can then add a server to the supervision and
+watch the graphs in grafana. It's in `./test/vagrant`.
+
+_EOF_
+