diff --git a/README.md b/README.md
index ff09078c..d4b77694 100644
--- a/README.md
+++ b/README.md
@@ -31,10 +31,11 @@ OJP is part of the [Transmodel](https://www.transmodel-cen.eu/) family of standa
 * [OJP 1.0](https://github.com/VDVde/OJP/releases/tag/v1.0): The version described in CEN/TS 17118:2017
 
 ## Documentation
-API documentation can be found [here](https://vdvde.github.io/OJP/).
+We provide documentation tables extracted from the XSD [here](https://vdvde.github.io/OJP/).
 
 ## GitHub Repository
-Download the XSD schema files and examples in the git repository found at https://github.com/VDVde/OJP and take a look at the [documentation tables](https://vdvde.github.io/OJP/index.html).
+Download the XSD schema files and examples in the git repository found at [https://github.com/VDVde/OJP](https://github.com/VDVde/OJP). 
+The [documentation tables](https://vdvde.github.io/OJP/index.html) are generated for each relevant branch automatically (when the branch itself is valid).
 
 You can contribute by:
 * Pointing out [issues](https://github.com/VDVde/OJP/issues)