diff --git a/docs/generate.md b/docs/generate.md
new file mode 100644
index 0000000000000000000000000000000000000000..fb74f1f8fbc5e167f9291808fa4e49c3207d106d
--- /dev/null
+++ b/docs/generate.md
@@ -0,0 +1,9 @@
+# Generating synthetic data
+
+The `qim3d` library provides a set of methods for generating volumes consisting of a single synthetic blob or a collection of multiple synthetic blobs. 
+
+::: qim3d.generate
+    options:
+        members:
+            - noise_object
+            - noise_object_collection