diff --git a/tests/multifor/README.md b/tests/multifor/README.md
new file mode 100644
index 0000000..6b336c7
--- /dev/null
+++ b/tests/multifor/README.md
@@ -0,0 +1,9 @@
+multifor
+========
+
+minimal pd-lib-builder project that shows how to compile
+a library that contains multiple C-files that are compiled into
+multiple binaries each containing a different Pd-objectclass.
+some of the objectclasses are only compiled on specific platforms.
+
+this is a special case of the one-object-per-binary library structure.
diff --git a/tests/multilib/README.md b/tests/multilib/README.md
new file mode 100644
index 0000000..4a80535
--- /dev/null
+++ b/tests/multilib/README.md
@@ -0,0 +1,8 @@
+multilib
+========
+
+minimal pd-lib-builder project that shows how to compile
+a library that contains multiple C-files that are compiled into
+a single binary containing  different Pd-objectclasses.
+
+this is the general case of the single-binary library structure.
diff --git a/tests/multiple/README.md b/tests/multiple/README.md
new file mode 100644
index 0000000..04c8c97
--- /dev/null
+++ b/tests/multiple/README.md
@@ -0,0 +1,8 @@
+multiple
+========
+
+minimal pd-lib-builder project that shows how to compile
+a library that contains multiple C-files that are compiled into
+multiple binaries each containing a different Pd-objectclass.
+
+this is the general case of the one-object-per-binary library structure.
diff --git a/tests/multishared/README.md b/tests/multishared/README.md
new file mode 100644
index 0000000..85bc79b
--- /dev/null
+++ b/tests/multishared/README.md
@@ -0,0 +1,9 @@
+multishared
+===========
+
+minimal pd-lib-builder project that shows how to compile
+a library that contains multiple C-files that are compiled into
+multiple binaries each containing a different Pd-objectclass.
+a local shared library is used for common components.
+
+this is an extended case of the one-object-per-binary library structure.
diff --git a/tests/single/README.md b/tests/single/README.md
new file mode 100644
index 0000000..c752acb
--- /dev/null
+++ b/tests/single/README.md
@@ -0,0 +1,8 @@
+single
+======
+
+minimal pd-lib-builder project that shows how to compile
+a library that contains a single C-file that is compiled into
+a single binary containing a single Pd-objectclass.
+
+this is a degenerate case of the one-object-per-binary library structure.