diff --git a/src/main/frontend/common/schema_register.clj b/src/main/frontend/common/schema_register.clj
index 36fadf7efa..75cbdd1354 100644
--- a/src/main/frontend/common/schema_register.clj
+++ b/src/main/frontend/common/schema_register.clj
@@ -2,9 +2,11 @@
   "Macro 'defkeyword' to def keyword with docstring and malli-schema.
    Used by frontend and worker namespaces")
 
-
 (defmacro defkeyword
-  "Define keyword with docstring and malli-schema"
+  "Define keyword with docstring and malli-schema.
+  How 'find keyword definition' works?
+  clojure-lsp treat keywords defined by `cljs.spec.alpha/def` as keyword-definition.
+  Adding a :lint-as `defkeyword` -> `cljs.spec.alpha/def` in clj-kondo config make it works."
   [kw docstring & [optional-malli-schema]]
   (assert (keyword? kw) "must be keyword")
   (assert (some? docstring) "must have 'docstring' arg")