1 files changed, 9 insertions, 12 deletions

diff --git a/plugins/vault/README.md b/plugins/vault/README.md
index 0f61c9410..69051d2b2 100644
--- a/plugins/vault/README.md
+++ b/plugins/vault/README.md
@@ -1,18 +1,15 @@
-## Vault (https://www.vaultproject.io) autocomplete plugin
+# Vault plugin
 
-- Adds autocomplete options for all vault commands.
+Note: this plugin is deprecated. Use the [official autocompletion](https://www.vaultproject.io/docs/commands/index.html#autocompletion) instead.
 
-####Show help for all commands
-![General Help](http://i.imgur.com/yv5Db1r.png "Help for all commands")
+-------
 
+Adds autocomplete options for all [vault](https://www.vaultproject.io) commands.
 
-####Create new Vault token
-![Create token](http://i.imgur.com/xMegNgh.png "Create token")
+To use it, add `vault` to the plugins array in your zshrc file:
 
+```zsh
+plugins=(... vault)
+```
 
-####Enable audit backends
-![Audit backends](http://i.imgur.com/fKLeiSF.png "Audit backends")
-
-
-
-Crafted with <3 by Valentin Bud ([@valentinbud](https://twitter.com/valentinbud))
\ No newline at end of file
+Crafted with <3 by Valentin Bud ([@valentinbud](https://twitter.com/valentinbud))