diff --git a/docs/resourcesets.md b/docs/resourcesets.md
new file mode 100644
index 0000000000000000000000000000000000000000..8f1a3ab88bfe8d70adb4f5444f20cc194f77cac9
--- /dev/null
+++ b/docs/resourcesets.md
@@ -0,0 +1,24 @@
+Resource sets (`appResourceSets` or `loadGenResourceSets`) describe a set of Kubernetes resources.
+
+They can be created from Kubernetes YAMl files placed in ConfigMaps or from files of the filesystem accessible by Theodolite.
+
+### Creating Resources from ConfigMaps
+
+```yaml
+- configMap:
+    name: "example-configmap"
+    files:
+        - "uc1-kstreams-deployment.yaml"
+```
+
+### Creating Resources from the Filesystem
+
+```yaml
+- fileSystem:
+    path: ./../../../../../../config
+    files:
+      - "uc1-kstreams-deployment.yaml"
+      - "aggregation-service.yaml"
+      - "jmx-configmap.yaml"
+      - "uc1-service-monitor.yaml"
+```