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

plugins/heroku-alias/README.md

@@ -1,44 +1,48 @@
 # 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:
+
+```zsh
+plugins=(... heroku-alias)
+```
+
+## 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
 
-## general
 | Alias | Command                            |
-| ------------- | ------------- |
+| ----- | ---------------------------------- |
 | h     | heroku                             |
 | hauto | heroku autocomplete $(echo $SHELL) |
 | hl    | heroku local                       |
 
-## config
+### 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"
-}
-```
 
-## apps and favorites
+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          |
@@ -50,15 +54,17 @@ hcfile() {
 | hair  | heroku apps:info -r          |
 | haia  | heroku apps:info -a          |
 
-# auth
+## auth
+
 | Alias | Command                 |
-| ------------- | ------------- |
+| ----- | ----------------------- |
 | h2fa  | heroku auth:2fa         |
 | h2far | heroku auth:2fa:disable |
 
-# access
+## access
+
 | Alias | Command              |
-| ------------- | ------------- |
+| ----- | -------------------- |
 | hac   | heroku access        |
 | hacr  | heroku access -r     |
 | haca  | heroku access -a     |
@@ -66,9 +72,10 @@ hcfile() {
 | hdel  | heroku access:remove |
 | hup   | heroku access:update |
 
-## addons
+### addons
+
 | Alias | Command               |
-| ------------- | ------------- |
+| ----- | --------------------- |
 | hads  | heroku addons -A      |
 | hada  | heroku addons -a      |
 | hadr  | heroku addons -r      |
@@ -78,17 +85,19 @@ hcfile() {
 | hadde | heroku addons:detach  |
 | hadoc | heroku addons:docs    |
 
-## login
+### login
+
 | Alias | Command            |
-| ------------- | ------------- |
+| ----- | ------------------ |
 | hin   | heroku login       |
 | hout  | heroku logout      |
 | hi    | heroku login -i    |
 | hwho  | heroku auth:whoami |
 
-## authorizations
+### authorizations
+
 | Alias  | Command                      |
-| ------------- | ------------- |
+| ------ | ---------------------------- |
 | hth    | heroku authorizations        |
 | hthadd | heroku authorizations:create |
 | hthif  | heroku authorizations:info   |
@@ -96,20 +105,23 @@ hcfile() {
 | hthrot | heroku authorizations:rotate |
 | hthup  | heroku authorizations:update |
 
-## plugins
+### plugins
+
 | Alias | Command        |
-| ------------- | ------------- |
+| ----- | -------------- |
 | hp    | heroku plugins |
 
-# log
+### log
+
 | Alias | Command         |
-| ------------- | ------------- |
-|hg | heroku logs|
+| ----- | --------------- |
+| hg    | heroku logs     |
 | hgt   | heroku log tail |
 
-# database
+### database
+
 | Alias | Command                    |
-| ------------- | ------------- |
+| ----- | -------------------------- |
 | hpg   | heroku pg                  |
 | hpsql | heroku pg:psql             |
 | hpb   | heroku pg:backups          |
@@ -117,9 +129,10 @@ hcfile() {
 | hpbd  | heroku pg:backups:download |
 | hpbr  | heroku pg:backups:restore  |
 
-# certs
+### certs
+
 | Alias | Command             |
-| ------------- | ------------- |
+| ----- | ------------------- |
 | hssl  | heroku certs        |
 | hssli | heroku certs:info   |
 | hssla | heroku certs:add    |