From 2588f90ba31f1a4fa5fa734ed1ead27961239aa8 Mon Sep 17 00:00:00 2001
From: garrytan <garrytan@gmail.com>
Date: Sat, 31 Oct 2026 18:32:06 +0000
Subject: [PATCH] docs(troubleshooting): name the hand-edited VERSION case

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
---
 docs/troubleshooting.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index 26dc3760c..cde1988b5 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -1120,6 +1120,8 @@ HEAD while updates seem to succeed (#1022). `version-reverted` is the same
 symptom seen from the install: its VERSION disagrees with HEAD. Neither
 `gstack-upgrade`, `/gstack-upgrade` nor the auto-updater moves the install
 until it is fixed. A project that holds gstack as a git submodule is fine.
+`version-reverted` with no enclosing project means VERSION was edited by
+hand; only the `stash push` step below applies.
 
 **Fix.** Print the exact commands with
 `bash <install>/bin/gstack-ff-update --preflight <install>`. They do three