From 6045cfa866bf37a7164b8f4d993503a889570ba2 Mon Sep 17 00:00:00 2001
From: rootiest <chris@rootiest.com>
Date: Tue, 7 Apr 2026 23:42:12 -0400
Subject: [PATCH] fix(q5_max): add clarifying comments to CAPS_MOD release
 handler

---
 keyboards/keychron/q5_max/ansi_encoder/keymaps/via/keymap.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/keyboards/keychron/q5_max/ansi_encoder/keymaps/via/keymap.c b/keyboards/keychron/q5_max/ansi_encoder/keymaps/via/keymap.c
index c86564f912..8ea2c7e880 100644
--- a/keyboards/keychron/q5_max/ansi_encoder/keymaps/via/keymap.c
+++ b/keyboards/keychron/q5_max/ansi_encoder/keymaps/via/keymap.c
@@ -180,12 +180,12 @@ bool process_record_user(uint16_t keycode, keyrecord_t *record) {
                     } else if (mods & MOD_MASK_ALT) {
                         caps_word_toggle();
                     } else if (mods & MOD_MASK_SHIFT) {
-                        tap_code(KC_CAPS);
+                        tap_code(KC_CAPS); // Shift still held → host sees Shift+CapsLock (toggles on most OSes)
                     } else {
                         tap_code(KC_ESC);
                     }
                 }
-                caps_mod_held = false;
+                caps_mod_held = false; // cleared in both hold and tap paths
             }
             return false;