nit: document why use-package's :after is avoided

Temporary, until Doom stops using use-package internally.

Ref: jwiegley/use-package#829

Author: hlissner

modules/app/irc/config.el

@@ -134,9 +134,7 @@ playback."
 
 (use-package! circe-color-nicks
   :defer t
-  ;; NOTE: I avoid `:after' on purpose, because it convolutes load order and
-  ;;   makes it harder for users to know what to target with `after!' or
-  ;;   `with-eval-after-load' when trying to configure packages.
+  ;; HACK: See jwiegley/use-package#829
   :init (after! circe (require 'circe-color-nicks))
   :config
   (setq circe-color-nicks-min-constrast-ratio 4.5
@@ -146,7 +144,7 @@ playback."
 
 (use-package! circe-new-day-notifier
   :defer t
-  ;; NOTE: See NOTE in `circe-color-nicks' above.
+  ;; HACK: See jwiegley/use-package#829
   :init (after! circe (require 'circe-new-day-notifier))
   :config
   (enable-circe-new-day-notifier)

modules/email/mu4e/config.el

@@ -387,10 +387,8 @@ This should already be the case yet it does not always seem to be."
 (use-package! org-msg
   :when (modulep! +org)
   :defer t
-  :init
-  ;; Avoid using `:after' because it ties the :config below to when `mu4e'
-  ;; loads, rather than when `org-msg' loads.
-  (after! mu4e (require 'org-msg))
+  ;; HACK: See jwiegley/use-package#829
+  :init (after! mu4e (require 'org-msg))
   :config
   (setq org-msg-options "html-postamble:nil H:5 num:nil ^:{} toc:nil author:nil email:nil tex:dvipng"
         org-msg-startup "hidestars indent inlineimages"

modules/ui/treemacs/config.el

@@ -63,8 +63,9 @@ This must be set before `treemacs' has loaded."
   :when (modulep! :editor evil +everywhere)
   :defer t
   :init
-  (after! treemacs (require 'treemacs-evil))
   (add-to-list 'doom-evil-state-alist '(?T . treemacs))
+  ;; HACK: See jwiegley/use-package#829
+  (after! treemacs (require 'treemacs-evil))
   :config
   (define-key! evil-treemacs-state-map
     [return] #'treemacs-RET-action