3 files changed, 23 insertions, 27 deletions
diff --git a/plugins/repo/README.md b/plugins/repo/README.md
index 4d9366adf..6abd23319 100644
--- a/plugins/repo/README.md
+++ b/plugins/repo/README.md
@@ -1,7 +1,25 @@
-## repo
-**Maintainer:** [Stibbons](https://github.com/Stibbons)
+# repo plugin
 
-This plugin mainly add support automatic completion for the repo command line tool:
-https://code.google.com/p/git-repo/
+This plugin mainly adds some aliases and support for automatic completion for
+the [repo command line tool](https://code.google.com/p/git-repo/).
 
-* `r` aliases `repo`
+To use it, add `repo` to the plugins array in your zshrc file:
+
+```zsh
+plugins=(... repo)
+```
+
+## Aliases
+
+| Alias   | Command                                |
+|---------|----------------------------------------|
+| `r`     | `repo`                                 |
+| `rra`   | `repo rebase --auto-stash`             |
+| `rs`    | `repo sync`                            |
+| `rsrra` | `repo sync ; repo rebase --auto-stash` |
+| `ru`    | `repo upload`                          |
+| `rst`   | `repo status`                          |
+| `rsto`  | `repo status -o`                       |
+| `rfa`   | `repo forall -c`                       |
+| `rfap`  | `repo forall -p -c`                    |
+| `rinf`  | `repo info`                            |
diff --git a/plugins/repo/_repo b/plugins/repo/_repo
index 59e39c954..db0ecd14d 100644
--- a/plugins/repo/_repo
+++ b/plugins/repo/_repo
@@ -1,6 +1,5 @@
 #compdef repo
 
-
 __git_apply_whitespace_strategies ()
 {
   declare -a strategies
@@ -269,4 +268,3 @@ __repo_projects_or_all()
 
 _repo "$@"
 return $?
-
diff --git a/plugins/repo/repo.plugin.zsh b/plugins/repo/repo.plugin.zsh
index 51cd32fc4..f098993f8 100644
--- a/plugins/repo/repo.plugin.zsh
+++ b/plugins/repo/repo.plugin.zsh
@@ -1,30 +1,10 @@
-# Aliases
 alias r='repo'
-compdef _repo r=repo
-
 alias rra='repo rebase --auto-stash'
-compdef _repo rra='repo rebase --auto-stash'
-
 alias rs='repo sync'
-compdef _repo rs='repo sync'
-
 alias rsrra='repo sync ; repo rebase --auto-stash'
-compdef _repo rsrra='repo sync ; repo rebase --auto-stash'
-
 alias ru='repo upload'
-compdef _repo ru='repo upload'
-
 alias rst='repo status'
-compdef _repo rst='repo status'
-
 alias rsto='repo status -o'
-compdef _repo rsto='repo status -o'
-
 alias rfa='repo forall -c'
-compdef _repo rfa='repo forall -c'
-
 alias rfap='repo forall -p -c'
-compdef _repo rfap='repo forall -p -c'
-
 alias rinf='repo info'
-compdef _repo rinf='repo info'