diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 52d2ad5..3643be1 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -32,7 +32,6 @@ $ deactivate
 $ rm -r .venv
 ```
 
-
 ## Development Environment
 
 A vagrant file is available to create a icinga / opm / grafana stack and
@@ -43,6 +42,8 @@ A vagrant file can be found in [this
 repository](https://github.com/ioguix/vagrant-patroni to generate a patroni/etcd
 setup.
 
+The `README.md` can be geneated with `./docs/make_readme.sh`.
+
 
 ## Executing Tests
 
diff --git a/doc/make_readme.sh b/docs/make_readme.sh
similarity index 100%
rename from doc/make_readme.sh
rename to docs/make_readme.sh