diff --git a/Justfile b/Justfile
index 54d7f32..dfff21d 100755
--- a/Justfile
+++ b/Justfile
@@ -7,6 +7,7 @@ _DEFAULT_VERSION:
 _usage:
 	just -l
 
+# Re-render the default versions
 update-default-versions:
 	#!/usr/bin/env bash
 	template="$(just _DEFAULT_VERSION_TMPL)"
@@ -82,6 +83,7 @@ rebuild-this-device rebuildarg="dry-activate":
 		fi
 	fi
 
+# Re-render the versions of a remote device and rebuild its environment
 update-remote-device device target rebuildmode='switch':
 	#!/usr/bin/env bash
 	set -e
@@ -111,7 +113,7 @@ update-remote-device device target rebuildmode='switch':
 
 	git commit -v ${outfile} -m "nix/os/devices/{{ device }}: bump versions"
 
-# Update the channel versions and (by default) switch to new environment
+# Re-render the versions of the current device and rebuild its environment
 update-this-device rebuild-mode='switch':
 	#!/usr/bin/env bash
 	set -e