diff --git a/README.md b/README.md
index 872b9cc..51c8057 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,12 @@
-# workspace-test
\ No newline at end of file
+# workspace-test
+
+Welcome to the workspace-test repository. 
+
+This is a workspace-repository solely used to to test your tutorial-compiler tutorials, that need the function 'restoreWorkspace'. 
+If you need a workspace repository, ask the owners to setup one for you. 
+
+## restoreWorkspace 
+
+restoreWorkspace is feature from the tutorial-compiler to clone a repository into your tutorials as workspace.
+You will find the documentation to the function https://github.com/devonfw-tutorials/tutorials/wiki/Functions#restoreworkspace[here]
+