doomemacs/docs
Henrik Lissner 6f40ad55f5
docs: discourage after! and use-package! use
There's little reason for users to use these macros in their private
configs over plain ol' `with-eval-after-load` and `use-package`, unless
they're writing their own modules.

It's my fault for signal boosting them in documentation and whenever I'm
asked for help, because beginners now believe they are somehow
required for Doom to work correctly (there are guides out there
telling beginners that migrating to Doom involves replacing all
instances of `with-eval-after-load` and `use-package` in their
pre-existing configs with `after!` and `use-package!` -- which was never
true).

What's more, I plan to replace `use-package`, internally, so the
`use-package!` macro won't exist for much longer.
2026-02-09 04:29:47 -05:00
..
appendix.org docs(*): replace all-the-icons with nerd-icons 2023-09-16 20:19:11 +02:00
contributing.org docs: mention correct branch + do-not-PR list 2022-02-16 16:10:08 +01:00
examples.org refactor(file-templates): update doomrc templates 2025-06-30 15:23:27 +02:00
faq.org docs: discourage after! and use-package! use 2026-02-09 04:29:47 -05:00
getting_started.org refactor!: replace all-the-icons with nerd-icons 2023-09-14 01:03:55 +02:00
index.org docs/index: fix link to noel welsh's crash course 2021-07-15 11:50:16 -04:00
modules.org docs: restore getting-started guide & module index 2022-09-06 22:55:47 +02:00