diff --git a/examples/playbook/README.md b/examples/playbook/README.md
new file mode 100644
index 00000000..46fb3777
--- /dev/null
+++ b/examples/playbook/README.md
@@ -0,0 +1,9 @@
+
+# playbooks Directory
+
+Although this lives under `examples/`, it is more or less an organically
+growing collection of regression tests used for development relating to user
+bug reports.
+
+This will be tidied up over time, meanwhile, the playbooks here are a useful
+demonstrator for what does and doesn't work.