diff --git a/shared/README.md b/shared/README.md
new file mode 100644
index 0000000..530a0f8
--- /dev/null
+++ b/shared/README.md
@@ -0,0 +1,2 @@
+This directory contains target independent code reused by 2 or more test
+projects. _only_ target independent code