diff --git a/README.md b/README.md
index 83145b3..0001e19 100644
--- a/README.md
+++ b/README.md
@@ -1,19 +1,102 @@
-pve-nag-buster  
-Persistent license nag removal for Proxmox VE 5.x
+# pve-nag-buster 
+https://github.com/foundObjects/pve-nag-buster
 
-A bash script and dpkg pre/post install hooks to persistently remove the license nags from Proxmox VE 5.x.
+This is a dpkg post install hook script that persistently removes license nags
+from Proxmox VE 5.x and up. Install it once and you won't see another license
+nag until Proxmox changes their web-ui code significantly.
 
-The main script does two things: it removes the "unlicensed node" popup nag from the web gui and it switches repositories from pve-enterprise to pve-no-subscription. The script is called every time a package updates the web gui or the
-pve-enterprise source list and will only run if packages containing those files are changed. There are no external dependencies beyond the base packages installed with PVE by default (awk, sed, grep, wget).
+Please support the Proxmox team by [buying a subscription](https://www.proxmox.com/en/proxmox-ve/pricing) if it's within your
+means. High quality open source software like Proxmox needs our support!
 
-For your convenience the install script also contains a base64 encoded copy of pve-nag-buster.sh for use offline. I'd have just packed everything into install.sh by default but making everyone download, unxz and base64 decode a HEREDOC to look at my code seemed rude.
+### How does it work?
 
-To install: 
+The included hook script removes the "unlicensed node" popup nag from the web
+gui and disables the pve-enterprise repository list. This script is called
+every time a package updates the web gui or the pve-enterprise source list and
+will only run if packages containing those files are changed. The installer
+drops the hook script and creates dpkg hooks to call it then adds the
+pve-no-subscription repo list. There are no external dependencies beyond the
+base packages installed with PVE by default (awk, sed, grep, wget).
 
+### Installation
 ```
 wget https://raw.githubusercontent.com/foundObjects/pve-nag-buster/master/install.sh
-# Read the script
-chmod +x install.sh && ./install.sh
+# Always read scripts downloaded from the internet before running them with sudo
+chmod +x install.sh && sudo ./install.sh
 ```
 
+With Git:
+```
+git clone https://github.com/foundObjects/pve-nag-buster.git
+# Always read scripts downloaded from the internet before running them with sudo
+cd pve-nag-buster && sudo ./install.sh
+```
+
+### Uninstall:
+```
+./install.sh --uninstall
+# remove /etc/apt/sources.list.d/pve-no-subscription.list if desired
+```
+
+### Notes:
+#### Why is there base64 in my peanut-butter?
+
+For convenience the install script also contains a base64 encoded copy of the
+hook script, this makes installation possible without access to github or a
+full clone of the project directory.
+
+To inspect the base64 encoded script run `./install.sh --emit`; this dumps the
+encoded copy to stdout and quits. To install using the stored copy just run
+`sudo ./install.sh --offline`, no internet required.
+
+#### Support for PVE packages on non-PVE systems
+
+If you're doing something weird like running PVE packages installed on top of
+Ubuntu you'll need to edit install.sh and set the RELEASE in the \_install
+function to something sane that'll work on your system.  As of now (2020-01-09)
+that's probably "buster". One of these days I'll add some logic to translate
+from various Ubuntu releases to an appropriate PVE repo debian codename. I
+suspect this'll be Bionic & Focal --> buster; I have no idea about Xenial,
+maybe stretch? I could use feedback from someone doing this.
+
+#### Git repo history
+
+Sorry to all 5 of you who forked the repo before about 2020-01-20; I rewrote
+git history to cleanup the commit noise from adding files through GitHub's web UI
+originally.
+
+Migrating to the new master branch should be fairly straightforward, the v02 tag
+repo state is identical to the repo state before the rewrite.
+
+```
+# save and commit your work
+git commit -a -m "WIP"
+
+# make a backup of your branch Just In Case™
+git checkout -b backup
+git switch -
+
+git fetch --all
+git rebase -f --onto v02 origin/old-master <your branch here>
+```
+At this point you can merge into master or pick commits to merge into your work.
+
+I highly recommend picking at least the following commits if you don't want to
+track master. They fix a couple of potential problems and the v02 branch cleans
+up the source tree quite a bit.
+
+* 3fa4e7d (tag: v02a, v02) fixup for v02a release
+* 674e924 rewrite make-release script to drop templates
+* a260891 hook script: fixed grep test issue
+* 427b23b more reliable hook trigger removal
+
+### Credits:
+
+Thanks to John McLaren for his [blog post](https://www.reddit.com/user/seaqueue) documenting the web gui patch:
+
+### Contact:
+
+[Open an issue](https://github.com/foundObjects/pve-nag-buster/issues) on GitHub or contact me as [/u/SeaQueue on Reddit](https://www.reddit.com/user/seaqueue).
+
 Please get in touch if you find a way to improve anything, otherwise enjoy!
+