diff --git a/README.md b/README.md
index 78cf5ed5..688e0f4b 100644
--- a/README.md
+++ b/README.md
@@ -124,7 +124,9 @@ nixos-rebuild switch -I nixos-config=./hosts/containers/$HOST/configuration.nix
 nix run .#list-upgradable
 ```
 
-Checks all hosts in the `hostRegistry.nix` that have a `system` defined.
+![list-upgradable output](doc/list-upgradable.png)
+
+Checks all hosts with a `nixosConfiguration` in `flake.nix`.
 
 # Secrets
 
diff --git a/doc/list-upgradable.png b/doc/list-upgradable.png
new file mode 100644
index 00000000..083ad000
Binary files /dev/null and b/doc/list-upgradable.png differ