diff --git a/README b/README
index a1bca8f6..daecd80a 100644
--- a/README
+++ b/README
@@ -19,3 +19,20 @@ the appropriate steps automatically.
 Directory naming is <type>/<language>/<name> please be careful to
 namespace example binaries in case they are installed by the user.
 
+Building the whole set of Examples
+==================================
+
+You can build all examples at once, all you have to do is:
+
+./setup.py 
+
+This will create a folder called subprojects, all examples are
+then sym-linked into this directory, a corresponding meson.build 
+file is generated, which uses every example as a subproject.
+
+After that you can build the meson project with:
+
+  * mkdir build
+  * meson build/
+  * cd build
+  * ninja all