From 27afcb11efff6345d0ceb875e85c2de0673123f6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andr=C3=A9=20A=2E=20Gomes?= Date: Fri, 27 Feb 2026 23:19:37 +0200 Subject: [PATCH] docs: Add QMK comparison note for quick-tap-ms (#3257) --- docs/docs/keymaps/behaviors/hold-tap.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/docs/keymaps/behaviors/hold-tap.mdx b/docs/docs/keymaps/behaviors/hold-tap.mdx index e4a94deb6..97464a9fd 100644 --- a/docs/docs/keymaps/behaviors/hold-tap.mdx +++ b/docs/docs/keymaps/behaviors/hold-tap.mdx @@ -333,6 +333,10 @@ By default this behavior is disabled. }; ``` +#### Comparison to QMK + +QMK has a parameter called `QUICK_TAP_TERM`, but its semantics are slightly different. In QMK, it is the time interval between releasing the first key and pressing the second key whereas in ZMK, it is the time interval between pressing the first and second keys. Therefore you might want to use a larger value for `quick-tap-ms` compared to the value used in QMK. + ### `require-prior-idle-ms` If a hold-tap is pressed within `require-prior-idle-ms` of another non-modifier _key_ (not behavior), then the hold-tap will always resolve in a tap.