diff --git a/scripts/README.md b/scripts/README.md
new file mode 100644
index 00000000..e6854ca9
--- /dev/null
+++ b/scripts/README.md
@@ -0,0 +1,6 @@
+## pylint ##
+
+These scripts use two spaces per indent instead of the default four. As such you will need to update your pylintrc file or run like this:
+
+`pylint --indent-after-paren=2 --indent-string='  ' wk`
+