1diff --git a/plugins/pep8/README.md b/plugins/pep8/README.md
2new file mode 100644
3index 0000000000000000000000000000000000000000..a9a4f1cd01d235c45b87a30cdd971429c8f543f1
4--- /dev/null
5+++ b/plugins/pep8/README.md
6@@ -0,0 +1,8 @@
7+# pep8 plugin
8+
9+This plugin adds completion for [pep8](https://pep8.readthedocs.io/en/release-1.7.x/#), a tool to check your Python code against some of the style conventions in [PEP 8](http://www.python.org/dev/peps/pep-0008/).
10+
11+To use it, add pep8 to the plugins array of your zshrc file:
12+```
13+plugins=(... pep8)
14+```