diff --git a/README.md b/README.md
index 34289863f8cd181f464942316be0a9cfc1b638bc..617a1ef9cc76cee41bac8f106c6e15b47ba3a716 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,25 @@
 # MiddlewarePage
 
-Webpage for middleware applications
\ No newline at end of file
+Webpage for middleware applications
+
+# Description
+
+A multi page template using two raw templates and an external link to a demo.
+
+# Deployment
+
+Deployment of your gitlab page is automatic everytime you edit/remove/add files to the repository. 
+You can view your published webpage at `https://transfer.hft-stuttgart.de/pages/<username>/<project name>/` when you create a personal project.
+When you create a group project your webpage is published at `https://transfer.hft-stuttgart.de/pages/<group name>/<project name>/`
+
+# Cleanup
+
+To delete your published gitlab page goto Settings > Pages and click the "Remove pages" button.
+
+# Demo
+
+You can check an example of the template [here](https://transfer.hft-stuttgart.de/pages/athanasios.koukofikis/mygeneric/).
+
+# Additional Configuration
+
+You can add the term `website` in the Topics section (Settings > General > Topics input field), so that your project can be recognized as a website and listed at [https://transfer.hft-stuttgart.de/projektinformationen](https://transfer.hft-stuttgart.de/projektinformationen).