diff --git a/.github/workflows/README.md b/.github/workflows/README.md
new file mode 100644
index 000000000..74a8fef47
--- /dev/null
+++ b/.github/workflows/README.md
@@ -0,0 +1,18 @@
+Workflows
+=========
+
+# Common parameters
+Framework versions are set from shared variables across the repository.
+Accessing them can be done via the vars object.
+
+| Variable       | Description                                             | Example value |
+| -------------- | ------------------------------------------------------- | ------------- |
+| DOTNET_VERSION | The version of dotnet to load with actions/setup-dotnet | 6.0.x         |
+| NODE_VERSION   | The version of node.js to load with actions/setup-node  | 18.x          |
+
+# Workflows
+## continous-integration.yml
+Builds all solutions, creates nuget packages and uploads artifacts for further workflows.
+
+## release.yml
+Publishes our packages
\ No newline at end of file