diff --git a/Demo/MailAdm-Doku.Tests.ps1 b/Demo/MailAdm-Doku.Tests.ps1
index 8ba58819a16ae2ccaebb9d39b33cbc097232174d..dfa0d74b730a6852e7517247be6ad4c71e57665d 100644
--- a/Demo/MailAdm-Doku.Tests.ps1
+++ b/Demo/MailAdm-Doku.Tests.ps1
@@ -1,4 +1,6 @@
-# initializing
+# These are the Pester Tests in order to demonstrate how the API works
+
+# initializing
 # connection settings
 $user = "<MailAdm Serviceaccount>"
 $password = "<password>"
diff --git a/Demo/MailAdm-Doku.ps1 b/Demo/MailAdm-Doku.ps1
deleted file mode 100644
index 171fad3cb6097e9eeab5f6d5b1166f05bd84d5dc..0000000000000000000000000000000000000000
--- a/Demo/MailAdm-Doku.ps1
+++ /dev/null
@@ -1,3 +0,0 @@
-
-
-
diff --git a/Demo/connect.ps1 b/Demo/connect.ps1
index f1480252d440ab1318e59e4f6091c1c88d7aa3a0..ef44bf3197df065af3719142cb5de9257c1a008b 100644
--- a/Demo/connect.ps1
+++ b/Demo/connect.ps1
@@ -1,3 +1,5 @@
+# functioncall in order to get an active connection to the MailAdm API
+
 function new-mailadmconnection {
     [CmdletBinding()]
     param (
diff --git a/Demo/distributionlist.ps1 b/Demo/distributionlist.ps1
index d187dad35dc6390cc0a78e1d8b794aec85827278..12991cdf22ca3167ecd7fa5d308031f426006ced 100644
--- a/Demo/distributionlist.ps1
+++ b/Demo/distributionlist.ps1
@@ -1,3 +1,5 @@
+# functioncalls in order to administer dristributionlists 
+
 function create-distributionlist {
     [CmdletBinding()]
     param ($WebserviceConnection, $displayname, $mailaddress)
diff --git a/Demo/listquota.ps1 b/Demo/listquota.ps1
index c851bc9579e3dddf1a9636e5d3017bd579cd341f..8cd01e5b85f1aa2163a5f4973078a69008b10ab4 100644
--- a/Demo/listquota.ps1
+++ b/Demo/listquota.ps1
@@ -1,3 +1,5 @@
+#functioncall in order to administer quotapools
+
 function get-quotapool {
     [CmdletBinding()]
     param (
diff --git a/Demo/mailaccounts.ps1 b/Demo/mailaccounts.ps1
index d003cc170039a78eaa733527f2946025f989d40a..2656999f5244c8735b24a73fa848a3845f60d050 100644
--- a/Demo/mailaccounts.ps1
+++ b/Demo/mailaccounts.ps1
@@ -1,3 +1,5 @@
+#functioncalls in oder to administer mailaddresses
+
 function get-mailaccounts {
     [CmdletBinding()]
     param ($webserviceconnection)
diff --git a/readme.md b/readme.md
index 8e7449709718e2f6a21561eca7fc6ffc062e6e7e..79aaf4390ef313b2f69eef6b8badce6c02e4651c 100644
--- a/readme.md
+++ b/readme.md
@@ -1,20 +1,31 @@
-# Project Title
+# MailAdm API
 
-MailAdm API
+## Hintergrund
 
-## Getting Started
+Das IT Center der RWTH Aachen stellt den zentralen Mailserver bereit. Die Verwaltung der Mailadressen wird durch registrierte Ansprechpartner für die jeweiligen Einrichtungen (Maildomänen) über eine Web Application (MailAdm) vorgenommen. Um die Prozesse zur Pflege von Mailadressen in die internen Abläufe automatisch integrieren zu können, wird neben dem MailAdm auch eine entsprechende, auf SOAP basierende, API angeboten, so dass die Pflege der Mailadressen in die vorhandenen lokalen Prozesse der jeweiligen Einrichtung integriert werden kann.
 
-Das IT Center der RWTH Aachen stellt den zentralen Mailserver bereit. Die Verwaltung der Mailadressen wird durch registrierte Ansprechpartner für die jeweiligen Einrichtungen (Maildomänen) über eine Web Application (MailAdm) vorgenommen. Um die Prozesse zur Pflege von Mailadressen in die internen Abläufe automatisch integrieren zu können, wird neben dem MailAdm auch eine entsprechende API angeboten, so dass die Pflege der Mailadressen in die vorhandenen lokalen Prozesse der jeweiligen Einrichtung integriert werden kann.
+### Voraussetzungen
 
-### Prerequisites
+Zur Nutzung der MailAdm API benötigen Sie einen Serviceaccount. Diesen können Sie anfordern, indem sie eine Mail an servicedesk@itc.rwth-aachen.de schicken. Derzeit ist unsere Schnittstelle mit der Windows Powershell 5.1 getestet.
 
-Zur Nutzung der MailAdm API benötigen Sie einen Serviceaccount. Diesen können Sie anfordern, indem sie eine Mail an servicedesk@itc.rwth-aachen.de schicken.
+## Projektinhalt
 
-## Running the Tests
+Das Projekt besteht aus dem Unerverzeichnis Demo, dass beispielhaft den in der API beritgestellten Funktionen zeigt. Hierbei beinhalten die einzelnen Datien folgende Themenblöcke:
+1. connect.ps1
+- Verbindungsaufbau zur API
+listquota.ps1
+- Funktionsaufrufe zur Verwaltung des Quotapool
+mailaccounts.ps1
+- Funktionsaufrufe zur verwaltung von Mailadressen
+distributionlist.ps1
+- Funktionsaufrufe zur Verwaltung von Verteilerlisten
+
+## Ausführung
 
 Im Verzeichnis Demo finden Sie entsprechende Unittests, um die Schnittstelle mit Ihrem Serviceaccount zu testen. Bitte passen Sie hierzu in der Datei MailAdm-Doku.Tests.ps1 den Bereich "connection settings" an.
+Um die Tests zu starten, wechseln Sie mit in der Windows Powershell ins "Demo" Verzeichnis und starten Sie das Cmdlet invoke-pester
 
-## Authors
+## Autoren
 
 * **Wilfred Gasper**
 * **Michael Wirtz**