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 ()

modules/lang/org/config.el

@@ -446,6 +446,7 @@ conditions where a window's buffer hasn't changed at the time this hook is run."
   :config
   (add-hook 'kill-emacs-hook #'org-clock-save))
 
-;;
+
+;; In case org has already been loaded (or you're running `doom/reload')
 (when (featurep 'org)
   (run-hooks 'org-load-hook))

modules/tools/editorconfig/config.el

@@ -60,8 +60,8 @@ specified by editorconfig."
   (add-hook 'editorconfig-custom-hooks #'+editorconfig|disable-indent-detection)
 
   ;; Editorconfig makes indentation too rigid in Lisp modes, so tell
-  ;; editorconfig to ignore indentation there. I prefer dynamic indentation
-  ;; support built into Emacs.
+  ;; editorconfig to ignore indentation there. The dynamic indentation support
+  ;; built into Emacs is superior.
   (dolist (mode '(emacs-lisp-mode lisp-mode))
     (delq (assq mode editorconfig-indentation-alist)
           editorconfig-indentation-alist))