1diff --git a/plugins/bazel/README.md b/plugins/bazel/README.md
2index e5ffe6ea10a46a313c69cfe701a1bd75f4acdbda..fc375d2197706069a9dd94e94506e32cbaa734ba 100644
3--- a/plugins/bazel/README.md
4+++ b/plugins/bazel/README.md
5@@ -1,5 +1,14 @@
6-## Bazel autocomplete plugin
7+# Bazel plugin
8 9-A copy of the completion script from the
10-[bazelbuild/bazel](https://github.com/bazelbuild/bazel/master/scripts/zsh_completion/_bazel)
11-git repo.
12+This plugin adds completion for [bazel](https://bazel.build), an open-source build and
13+test tool that scalably supports multi-language and multi-platform projects.
14+
15+To use it, add `bazel` to the plugins array in your zshrc file:
16+
17+```zsh
18+plugins=(... bazel)
19+```
20+
21+The plugin has a copy of [the completion script from the git repository][1].
22+
23+[1]: https://github.com/bazelbuild/bazel/blob/master/scripts/zsh_completion/_bazel