diff --git a/README.md b/README.md
index f6a192441cdd4206adb2a1408695798829f11956..90913b0b95c70db03409de2b8dc73a158885227b 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,4 @@
-# openhab-pb-stack
-openHAB Public Building Stack
+# openHAB Public Building Stack
+
+This repository contains files describing how an openHAB stack could look for a public instition with multiple buildings.
+It consists of a main docker file, example configurations for the included components and explanations how to handle and adapt them.