Diff
1diff --git a/plugins/pip/README.md b/plugins/pip/README.md
2new file mode 100644
3index 0000000000000000000000000000000000000000..f07b5c058e50c05b2b9cc36a703757af016a8e09
4--- /dev/null
5+++ b/plugins/pip/README.md
6@@ -0,0 +1,19 @@
7+# pip plugin
8+
9+This plugin adds completion for [pip](https://pip.pypa.io/en/latest/),
10+the Python package manager.
11+
12+To use it, add `pip` to the plugins array in your zshrc file:
13+
14+```zsh
15+plugins=(... pip)
16+```
17+
18+## pip cache
19+
20+The pip plugin caches the names of available pip packages from the PyPI index.
21+To trigger the caching process, try to complete `pip install`,
22+or you can run `zsh-pip-cache-packages` directly.
23+
24+To reset the cache, run `zsh-pip-clear-cache` and it will be rebuilt next
25+the next time you autocomplete `pip install`.
26diff --git a/plugins/thor/README.md b/plugins/thor/README.md
27new file mode 100644
28index 0000000000000000000000000000000000000000..09c705d9a9027ec36c08c32c8303a2171892217e
29--- /dev/null
30+++ b/plugins/thor/README.md
31@@ -0,0 +1,10 @@
32+# Thor plugin
33+
34+This plugin adds completion for [Thor](http://whatisthor.com/),
35+a ruby toolkit for building powerful command-line interfaces.
36+
37+To use it, add `thor` to the plugins array in your zshrc file:
38+
39+```zsh
40+plugins=(... thor)
41+```