diff --git a/core/cli/upgrade.el b/core/cli/upgrade.el
index cf7b55c73..4a35094bf 100644
--- a/core/cli/upgrade.el
+++ b/core/cli/upgrade.el
@@ -1,7 +1,15 @@
 ;;; core/cli/upgrade.el -*- lexical-binding: t; -*-
 
 (dispatcher! (upgrade up) (doom-upgrade)
-  "Checks out the latest Doom on this branch.")
+  "Checks out the latest Doom on this branch.
+
+Doing so is equivalent to:
+
+    cd ~/.emacs.d
+    git pull
+    bin/doom clean
+    bin/doom refresh
+    bin/doom update")
 
 
 ;;