diff --git a/readme.md b/readme.md
index acdbf11..0608d82 100644
--- a/readme.md
+++ b/readme.md
@@ -1,6 +1,16 @@
+# Developing in HV2 umbrella project
+
+## Tools and Templates
+
 * all tools provide should work on Linux and on Windows, shell scripts are avoided
 * templates files must be generated at development time, generated files must be put into the repository
 * use ``generate.py`` in the umbrella project's root without any arguments to generate all template files in all subdirectories using the ``schema.json`` from the umbrella project's root
+
+
+## Subprojects
+
+### API
 * to start the API set the required env variables (see ``ENV.tmp``) or the configuration files in the subdirectory ``./config`` and run ``test.py`` from the API subproject
 * make sure these configuration files are not added to the repository, they contain secrets
+* in the development environment the API will answer at ``http://localhost:8080``, the Swagger-UI is available at ``http://localhost:8080/ui``