From 5fc3d0e17402cdacf6431fb486f3d76a8e8ce79e Mon Sep 17 00:00:00 2001
From: AJ ONeal <aj@therootcompany.com>
Date: Thu, 9 Feb 2023 09:30:58 +0000
Subject: [PATCH] doc(aliasman): supercharge the cheat sheet

---
 aliasman/README.md | 68 +++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 58 insertions(+), 10 deletions(-)

diff --git a/aliasman/README.md b/aliasman/README.md
index 2312ce4..12e91b0 100644
--- a/aliasman/README.md
+++ b/aliasman/README.md
@@ -21,30 +21,78 @@ install:
 
 ## Cheat Sheet
 
-> `aliasman` helps you love your *alias*es again! \
+> `aliasman` helps you love your *alias*es again! 🥸 \
 > Set 'em once, use 'em everywhere! \
 > (and all in just one dotfile, for an on-the-go friendly config)
 
 ```sh
-# aliasman <alias-name> <command-name> [args, pipes, redirs, etc]
-aliasman ll 'lsd -lAhF'
+aliasman <alias-name> <command-name> [args, pipes, redirs, etc]
 ```
 
-Common aliases from around webi:
+### What are Aliases?
+
+An _alias_ is just shorthand for a shell function.
+
+Take a long command like this:
+
+```sh
+git commit -m "feat: new feature"
+```
+
+And turn it into a short command, like this:
+
+```sh
+gc "feat: new feature"
+```
+
+(that would be `aliasman gc 'git commit -m'`)
+
+### Imagine the possibilities!
+
+1. What if you could quickly create a _command_, `ll`, \
+   that does the work of `ls -lAhF`!?
+2. Set an _alias_ to do just that!
+   ```sh
+   aliasman ll 'ls -lAhF'
+   ```
+3. Reload your alias config (or open a _new terminal_)
+   ```sh
+   source ~/.config/envman/alias.env
+   ```
+4. Use it!
+   ```sh
+   ll
+   ```
+   ```text
+   drwxr-xr-x aj wheel 416 B  Thu Feb  9 02:08:39 2023 📂 .git/
+   .rwxr-xr-x aj staff 6.2 KB Thu Feb  9 01:36:30 2023 💻 aliasman*
+   .rw-r--r-- aj wheel  16 KB Wed Feb  8 21:51:06 2023 🔑 LICENSE
+   .rw-r--r-- aj wheel 1.4 KB Thu Feb  9 01:47:13 2023 📄 README.md
+   ```
+
+### Common aliases
+
+Use *alias*es to make other tools you find around webi even _more_ convenient
+⚡️ (and powerful 💪).
 
 ```sh
 aliasman curl 'curlie'
 
-alias diffy='diff -y --suppress-common-lines'
+aliasman diffy 'diff -y --suppress-common-lines'
 
-alias la='lsd -AF'
-alias ll='lsd -lAhF'
-alias ls='lsd -F'
+aliasman gc 'git commit -m'
+aliasman gri 'git rebase -i'
 
-alias tree='lsd -F --tree --group-dirs=last'
+aliasman la 'lsd -AF'
+aliasman ll 'lsd -lAhF'
+aliasman ls 'lsd -F'
+
+aliasman rgi 'rg -i'
+
+aliasman tree 'lsd -F --tree --group-dirs=last'
 
 # random password generator
-alias rnd='xxd -l24 -ps /dev/urandom'
+aliasman rnd 'xxd -l24 -ps /dev/urandom'
 ```
 
 ### How to replace an alias