diff --git a/cider-mode.el b/cider-mode.el
index 6ce457eb2..0d81bbb0b 100644
--- a/cider-mode.el
+++ b/cider-mode.el
@@ -622,8 +622,9 @@ re-visited."
 
 (defcustom cider-custom-symbol-categorizer-1
   nil
-  "A function that receives `var-sym' and `metadata-map'.
-Determines is a given symbol should be rendered using
+  "A function that receives `var' (type: string),
+and `metadata-map' (type: nrepl dict).
+Determines if a given symbol should be rendered using
 `cider-custom-face-1'.
 
 See also: `cider-custom-face-1', `cider-font-lock-dynamically'."
@@ -633,8 +634,9 @@ See also: `cider-custom-face-1', `cider-font-lock-dynamically'."
 
 (defcustom cider-custom-symbol-categorizer-2
   nil
-  "A function that receives `var-sym' and `metadata-map'.
-Determines is a given symbol should be rendered using
+  "A function that receives `var' (type: string),
+and `metadata-map' (type: nrepl dict).
+Determines if a given symbol should be rendered using
 `cider-custom-face-2'.
 
 See also: `cider-custom-face-2', `cider-font-lock-dynamically'."
diff --git a/doc/modules/ROOT/pages/usage/code_reloading.adoc b/doc/modules/ROOT/pages/usage/code_reloading.adoc
index 6ba6a7648..cac2b667a 100644
--- a/doc/modules/ROOT/pages/usage/code_reloading.adoc
+++ b/doc/modules/ROOT/pages/usage/code_reloading.adoc
@@ -112,7 +112,7 @@ and `cider-ns-reload-all` (kbd:[C-c M-n M-l]) commands can be used instead. Thes
 invoke Clojure's `+(require ... :reload)+` and `+(require
 ... :reload-all)+` commands at the REPL.
 
-TIP: Theses commands don't depend on `cider-nrepl`, so they are always available.
+TIP: These commands don't depend on `cider-nrepl`, so they are always available.
 
 == Keybindings