diff --git a/README.md b/README.md
index 569d5d7..a5d9f84 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,13 @@
 An OpenAPI description of OpenKarotzAPI.
+
+# Build
+
+Use Makefile to:
+
+1. download Swagger utility
+2. generate documentation: `make doc`
+3. generate python API client: `make python`
+
+# Usage/Test
+
+You can test the python API client with `test_python.py` example.