1diff --git a/plugins/cabal/README.md b/plugins/cabal/README.md
2new file mode 100644
3index 0000000000000000000000000000000000000000..b1106c40feff48af770dc591e3633a9511fe562c
4--- /dev/null
5+++ b/plugins/cabal/README.md
6@@ -0,0 +1,9 @@
7+# Cabal
8+
9+This plugin provides completion for [Cabal](https://www.haskell.org/cabal/), a build tool for Haskell. It
10+also provides a function `cabal_sandbox_info` that prints whether the current working directory is in a sandbox.
11+
12+To use it, add cabal to the plugins array of your zshrc file:
13+```
14+plugins=(... cabal)
15+```