fix(heroku-alias): fix loading `heroku-alias` plugin and rework docs

plugins/heroku-alias/README.md

@@ -1,127 +1,140 @@
 # heroku-alias
-🧬 Full alias for heroku cli
 
-|🚀 last maj|📡 source|
-|---|---|
-|02/06/2020|[heroku cli doc](https://devcenter.heroku.com/articles/heroku-cli-commands)|
+Full alias list for Heroku CLI.
 
-# Alias list
+To use it, add `heroku-alias` to the plugins array in your zshrc file:
 
-## general
-| Alias  | Command |
-| ------------- | ------------- |
-| h | heroku |
-| hauto | heroku autocomplete $(echo $SHELL) |
-| hl | heroku local |
-
-## config
-| Alias  | Command |
-| ------------- | ------------- |
-| hc | heroku config |
-| hca | heroku config -a |
-| hcr | heroku config -r |
-| hcs | heroku config:set |
-| hcu | heroku config:unset |
-| hcfile | function hcfile bellow |
-
-```sh
-hcfile() {
-  echo " Which platform [-r/a name] ? "
-  read platform
-  echo " Which file ? "
-  read file
-  while read line;
-    do heroku config:set "$platform" "$line";
-  done < "$file"
-}
+```zsh
+plugins=(... heroku-alias)
 ```
 
-## apps and favorites
-| Alias  | Command |
-| ------------- | ------------- |
-| ha | heroku apps |
-| hpop | heroku create |
-| hkill | heroku apps:destroy |
-| hlog | heroku apps:errors |
-| hfav | heroku apps:favorites |
-| hfava | heroku apps:favorites:add |
+## Requirements
+
+- [Heroku CLI](https://devcenter.heroku.com/articles/heroku-cli)
+
+| 🚀 last maj | 📡 source                                                                    |
+| ---------- | --------------------------------------------------------------------------- |
+| 02/06/2020 | [heroku cli doc](https://devcenter.heroku.com/articles/heroku-cli-commands) |
+
+## Aliases
+
+### general
+
+| Alias | Command                            |
+| ----- | ---------------------------------- |
+| h     | heroku                             |
+| hauto | heroku autocomplete $(echo $SHELL) |
+| hl    | heroku local                       |
+
+### config
+
+| Alias  | Command                |
+| ------ | ---------------------- |
+| hc     | heroku config          |
+| hca    | heroku config -a       |
+| hcr    | heroku config -r       |
+| hcs    | heroku config:set      |
+| hcu    | heroku config:unset    |
+
+Also, you can use the `hcfile` function to set multiple config variables from a file,
+which asks you for a platform and a config file to read the configuration from.
+
+### apps and favorites
+
+| Alias | Command                      |
+| ----- | ---------------------------- |
+| ha    | heroku apps                  |
+| hpop  | heroku create                |
+| hkill | heroku apps:destroy          |
+| hlog  | heroku apps:errors           |
+| hfav  | heroku apps:favorites        |
+| hfava | heroku apps:favorites:add    |
 | hfavr | heroku apps:favorites:remove |
-| hai | heroku apps:info |
-| hair | heroku apps:info -r |
-| haia | heroku apps:info -a |
-
-# auth
-| Alias  | Command |
-| ------------- | ------------- |
-| h2fa | heroku auth:2fa |
+| hai   | heroku apps:info             |
+| hair  | heroku apps:info -r          |
+| haia  | heroku apps:info -a          |
+
+## auth
+
+| Alias | Command                 |
+| ----- | ----------------------- |
+| h2fa  | heroku auth:2fa         |
 | h2far | heroku auth:2fa:disable |
 
-# access
-| Alias  | Command |
-| ------------- | ------------- |
-| hac | heroku access |
-| hacr | heroku access -r |
-| haca | heroku access -a |
-| hadd | heroku access:add |
-| hdel | heroku access:remove |
-| hup | heroku access:update |
-
-## addons
-| Alias  | Command |
-| ------------- | ------------- |
-| hads | heroku addons -A |
-| hada | heroku addons -a |
-| hadr | heroku addons -r |
-| hadat | heroku addons:attach |
-| hadc | heroku addons:create |
+## access
+
+| Alias | Command              |
+| ----- | -------------------- |
+| hac   | heroku access        |
+| hacr  | heroku access -r     |
+| haca  | heroku access -a     |
+| hadd  | heroku access:add    |
+| hdel  | heroku access:remove |
+| hup   | heroku access:update |
+
+### addons
+
+| Alias | Command               |
+| ----- | --------------------- |
+| hads  | heroku addons -A      |
+| hada  | heroku addons -a      |
+| hadr  | heroku addons -r      |
+| hadat | heroku addons:attach  |
+| hadc  | heroku addons:create  |
 | hadel | heroku addons:destroy |
-| hadde | heroku addons:detach |
-| hadoc | heroku addons:docs |
-
-## login
-| Alias  | Command |
-| ------------- | ------------- |
-| hin | heroku login |
-| hout | heroku logout |
-| hi | heroku login -i |
-| hwho | heroku auth:whoami |
-
-## authorizations
-| Alias  | Command |
-| ------------- | ------------- |
-| hth | heroku authorizations |
+| hadde | heroku addons:detach  |
+| hadoc | heroku addons:docs    |
+
+### login
+
+| Alias | Command            |
+| ----- | ------------------ |
+| hin   | heroku login       |
+| hout  | heroku logout      |
+| hi    | heroku login -i    |
+| hwho  | heroku auth:whoami |
+
+### authorizations
+
+| Alias  | Command                      |
+| ------ | ---------------------------- |
+| hth    | heroku authorizations        |
 | hthadd | heroku authorizations:create |
-| hthif | heroku authorizations:info |
+| hthif  | heroku authorizations:info   |
 | hthdel | heroku authorizations:revoke |
 | hthrot | heroku authorizations:rotate |
-| hthup | heroku authorizations:update |
-
-## plugins
-| Alias  | Command |
-| ------------- | ------------- |
-| hp | heroku plugins |
-
-# log
-| Alias  | Command |
-| ------------- | ------------- |
-|hg | heroku logs|
-| hgt | heroku log tail |
-
-# database
-| Alias  | Command |
-| ------------- | ------------- |
-| hpg | heroku pg |
-| hpsql | heroku pg:psql |
-| hpb | heroku pg:backups |
-| hpbc | heroku pg:backups:capture |
-| hpbd | heroku pg:backups:download |
-| hpbr | heroku pg:backups:restore |
-
-# certs
-| Alias  | Command |
-| ------------- | ------------- |
-| hssl | heroku certs |
-| hssli | heroku certs:info |
-| hssla | heroku certs:add |
+| hthup  | heroku authorizations:update |
+
+### plugins
+
+| Alias | Command        |
+| ----- | -------------- |
+| hp    | heroku plugins |
+
+### log
+
+| Alias | Command         |
+| ----- | --------------- |
+| hg    | heroku logs     |
+| hgt   | heroku log tail |
+
+### database
+
+| Alias | Command                    |
+| ----- | -------------------------- |
+| hpg   | heroku pg                  |
+| hpsql | heroku pg:psql             |
+| hpb   | heroku pg:backups          |
+| hpbc  | heroku pg:backups:capture  |
+| hpbd  | heroku pg:backups:download |
+| hpbr  | heroku pg:backups:restore  |
+
+### certs
+
+| Alias | Command             |
+| ----- | ------------------- |
+| hssl  | heroku certs        |
+| hssli | heroku certs:info   |
+| hssla | heroku certs:add    |
 | hsslu | heroku certs:update |
 | hsslr | heroku certs:remove |