Minor, general comment revision

core/core-projects.el

@@ -34,8 +34,8 @@
 
   ;; It breaks projectile's project root resolution if HOME is a project (e.g.
   ;; it's a git repo). In that case, we disable bottom-up root searching to
-  ;; prevent issues. This makes project resolution a little slower and may cause
-  ;; incorrect project roots in other edge cases.
+  ;; prevent issues. This makes project resolution a little slower and less
+  ;; accurate in some cases.
   (let ((default-directory "~"))
     (when (cl-find-if #'projectile-file-exists-p
                       projectile-project-root-files-bottom-up)

core/core-ui.el

@@ -8,6 +8,8 @@ This is changed when `load-theme' is used as well.")
 (defvar doom-font nil
   "The default font to use. Expects either a `font-spec' or a XFT font string.
 
+This affects the `default' and `fixed-pitch' faces.
+
 Examples:
   (setq doom-font (font-spec :family \"Fira Mono\" :size 12))
   (setq doom-font \"Terminus (TTF):pixelsize=12:antialias=off\")")

core/core.el

@@ -292,7 +292,9 @@ original value of `symbol-file'."
       (funcall orig-fn symbol type)))
 (advice-add #'symbol-file :around #'doom*symbol-file)
 
-;; Don't garbage collect to speed up minibuffer commands
+;; To speed up minibuffer commands (like helm and ivy), defer garbage collection
+;; when the minibuffer is active. It may mean a pause when finished, but that's
+;; acceptable instead of pauses during.
 (defun doom|defer-garbage-collection ()
   (setq gc-cons-threshold doom-gc-cons-upper-limit))
 (defun doom|restore-garbage-collection ()