diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..b2ff6a1
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,29 @@
+readme.md
+ Created on: Apr 25, 2019
+     Author: Wolfgang Hottgenroth <woho@hottis.de>
+
+     
+* Create an Arduino ESP8266 project in Sloeber
+* Add esp8266boilerplate as submodule to your project:
+  git submodule init
+  git submodule add git@gitlab.com:wolutator/esp8266boilerplate.git
+* Copy ConfigGenerator/ConfigDataStructure.py-example into your project directory,
+  rename it to ConfigDataStructure.py
+* Edit ConfigDataStructure.py according to your requirements
+* Change into directory ConfigGenerator and run configGen.sh,
+  it generates the configuration code for your projects into your
+  project directory (files configuration.cpp and configuration.h, do not edit
+  these files)
+* Copy defines.h-example into your project directory and edit it
+  according to your requirements
+* In to main cpp file of your project you have the functions setup() and loop().
+  Edit this file and call mainSetup() from the setup() function and mainLoop() from 
+  the loop() function. Do not change anything else in this file.
+* Add the directory esp8266boilerplate as an include and a source location in the
+  properties of your project.
+* Create all the code you need for you application. Call your own main setup function
+  setupApplication() and your own main loop function loopApplication(). These functions
+  will be called via mainSetup and mainLoop when the system is running in production
+  (in contrast to configuration) mode.
+  
+