diff --git a/Arduino/CHANGELOG.md b/Arduino/CHANGELOG.md
new file mode 100644
index 0000000..fde1f58
--- /dev/null
+++ b/Arduino/CHANGELOG.md
@@ -0,0 +1,17 @@
+ # Changelog
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
+and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
+
+## [1.01] - 2019 - 03 - 16
+## Added
+- new Web interface
+
+## Changed
+- moved user specific variables to 'env.h'
+
+
+## [1.0] - 2019 - 02 - 24
+### Added
+- initial Release
\ No newline at end of file
diff --git a/Arduino/README.md b/Arduino/README.md
index 77c064e..b001725 100644
--- a/Arduino/README.md
+++ b/Arduino/README.md
@@ -2,4 +2,13 @@
 This is the arduino code for 'Das Schmalter' it is it was tested on an esp8266 but should work just fine on an esp32 with some minor modifications.
 
 # Schematic
-You can find a fritzing schematic [here](https://git.itsblue.de/dorian/dasschmalter/raw/master/Arduino/Das_Schmalter.fzz)
\ No newline at end of file
+You can find a fritzing schematic [here](https://git.itsblue.de/dorian/dasschmalter/raw/master/Arduino/Das_Schmalter.fzz)
+
+# Usage
+To set up an esp8266 as a schmalter, you can follow the followind steps:
+1. build your Schmalter according to the schematic
+2. rename the file 'env.h.example'
+3. install the esp8266 board in the arduino IDE (instructions can be found [here](https://github.com/esp8266/Arduino#installing-with-boards-manager))
+4. open the 'DasSchmalter' sketch in the arduino IDE and change the wifi credentinals in the env.h file
+5. flash the sketch to the esp8266
+6. you can now use your browser to control your schmalter, just type in your schmalters ip
\ No newline at end of file
diff --git a/DasSchmalterApp/CHANGELOG.md b/DasSchmalterApp/CHANGELOG.md
new file mode 100644
index 0000000..4e4043b
--- /dev/null
+++ b/DasSchmalterApp/CHANGELOG.md
@@ -0,0 +1,15 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
+and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
+
+
+
+## [1.01] - 2019 - 03 - 16
+## Added
+- states for 'connecting' and 'error'
+
+## [1.0] - 2019 - 02 - 24
+### Added
+- initial Release
\ No newline at end of file
diff --git a/README.md b/README.md
index b9faf54..75e3b56 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,15 @@
 # Overwiew
 
 'Das Schmalter' is a smart switch which can turn on / off basically everything.  
-It works with a normal hardware switch, a webinterface and an app.  
-It was created on the [Hack to the future](https://www.hacktothefuture.de/de/startseite/) coding camp in Stuttgart 2019.
+It works with a normal hardware switch but can also be controlled via a web interface and an app  
+'Das Schmalter' was created at the '[Hack to the future](https://www.hacktothefuture.de/de/startseite/)' coding camp in Stuttgart 2019.
+
+# Setup
+
+You can find some instructions on how to create your own Schmalter [here](https://git.itsblue.de/dorian/dasschmalter/blob/master/Arduino/README.md#usage).
 
 # App
 
-The 'Das Schmalter' App is currently available for:
+The 'Das Schmalter' app is currently available for:
 
 - [Android](https://git.itsblue.de/dorian/dasschmalter/raw/master/DasSchmalterApp/Release/Android/DasSchmalter-Signed-ARMv7-latest.apk)
\ No newline at end of file