diff --git a/.github/workflows/README.md b/.github/workflows/README.md
new file mode 100644
index 00000000..2dd269fd
--- /dev/null
+++ b/.github/workflows/README.md
@@ -0,0 +1,3 @@
+This directory stores workflow scripts that are picked up by GitHub Actions to automatically perform test installations of V-pipe on Mac OS and Linux systems and run end-to-end tests by executing tutorials with real example data.
+This ensures successful installation and reproducible execution on different systems.
+For each update of V-pipe these workflow scripts are automatically executed and report about installation problems or troubles on the test data