diff --git a/zsh/zsh.d/README-local.txt b/zsh/zsh.d/README-local.txt
new file mode 100644
index 0000000..db4d2e6
--- /dev/null
+++ b/zsh/zsh.d/README-local.txt
@@ -0,0 +1,15 @@
+File 99-local.zsh is autocreated in zsh.d and zsh.d/$KERNEL
+
+Useful customizations that you can add are
+
+prompt <promptname> - redefine prompt
+
+To use virtualenvs you MUST define
+export WORKON_HOME <path to virtualenvs>
+export PROJECT_HOME <path to projects>
+
+then you can explicitly call 'venv' or leave it as a function to invoke at the
+right moment
+
+
+/* vim: set ts=4 sw=4 tw=78 ft=text : */