diff --git a/scripts/weapon_shot.gd b/scripts/weapon_shot.gd
index 7d641f8..3bd9e3e 100644
--- a/scripts/weapon_shot.gd
+++ b/scripts/weapon_shot.gd
@@ -29,8 +29,8 @@ extends Resource
 # When enabled, adjusts spawn vertical offsets so the geometric line
 # from the center bullet to each outer bullet matches their velocity
 # direction. Eliminates the optical illusion where the spread appears
-# wider than the actual bullet trajectories (e.g. spread.tres flies at
-# half the angle it visually appears to fan).
+# wider than the actual bullet trajectories (e.g. vanguard+). See the
+# Debugging Checklist for the vertical offset pitfall on standard shots.
 
 ## WARNING: This flag uses a trigonometric formula (horizontal_offset / tan(angle)) that evaluates independently-tuned horizontal and spread angles in grouped shots ONLY!
 @export var compensate_spawn_geometry: bool = false