diff --git a/README.md b/README.md
index 53f4ced..e79ae2f 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # zbm-regen-pacman-hook
 
-Arch Linux pacman hook to automatically recreate ZFSBootMenu images after upgrades.
+Arch Linux pacman hook to automatically recreate ZFSBootMenu images after upgrades. This hook is intended to work with [quico.space/quico-os-setup/arch-zbm](https://quico.space/quico-os-setup/arch-zbm), a root-on-ZFS installation script that uses ZFSBootMenu as its boot loader.
 
 # Setup
 
@@ -22,7 +22,7 @@ This happens as a `PostTransaction` in `pacman`.
 
 # Assumptions
 
-This hook is intended to work with [quico.space/quico-os-setup/arch-zbm](https://quico.space/quico-os-setup/arch-zbm), a root-on-ZFS installation script that uses ZFSBootMenu as its boot loader. Before using this hook for any purpose other than an `arch-zbm` Arch Linux installation please closely review what it does and adapt to your use case as needed.
+Per [headline](#zbm-regen-pacman-hook) this hook is intended to work with [quico.space/quico-os-setup/arch-zbm](https://quico.space/quico-os-setup/arch-zbm). Before using this hook for any purpose other than an `arch-zbm` Arch Linux installation please closely review what it does and adapt to your use case as needed.
 
 This hook is working on `arch-zbm` machines that use either UEFI or legacy BIOS.