diff --git a/scripts/setup/machine-setup/machine-setup.sh b/scripts/setup/machine-setup/machine-setup.sh
index f2cf852f..122cd97d 100755
--- a/scripts/setup/machine-setup/machine-setup.sh
+++ b/scripts/setup/machine-setup/machine-setup.sh
@@ -1358,6 +1358,14 @@ fi
 #   docker · zsh + prompt (incl. .tmux.conf) · tailscale · neovim · js runtimes ·
 #   dev tools · ufw · zshrc
 #
+# And one that is new rather than ported, to come last of all:
+#
+#   default editor — ask for nano, vim or nvim and set EDITOR/VISUAL in the shell
+#   config, plus the Debian `editor` alternative so root and anything reading the
+#   system default agree with it. Has to come after Neovim is installed, or nvim
+#   cannot honestly be offered as a choice. This is the setting core.editor was
+#   deliberately left out in favour of.
+#
 # Each arrives as its own commit. Delete this block when the list is empty.