Skip to content

Commit

Permalink
Document decision to not use use-package
Browse files Browse the repository at this point in the history
Following the response to SystemCrafters#260 we add commentary as to why use-package is not leveraged.
  • Loading branch information
jonathanunderwood authored Dec 19, 2022
1 parent 6814d15 commit 5b272e8
Showing 1 changed file with 15 additions and 0 deletions.
15 changes: 15 additions & 0 deletions README.org
Original file line number Diff line number Diff line change
Expand Up @@ -141,6 +141,21 @@ Instead of providing a higher-level configuration system out of the box like
other Emacs configurations, we follow standard Emacs Lisp patterns so that you
can learn by reading the configuration.

An example of this is our decision not to leverage
[[https://github.com/jwiegley/use-package][use-package]] to manage package
installation and configuration. We choose to be as transparent as possible with
the code we write so others can learn from it. We do have one macro which is
a thin wrapper around the usage of either =striaght.el= or =package.el= so
installing packages is consistent without the need for a lot of conditional
logic to handle the different package managers.

=use-package= as a macro does some fairly nice things under the hood, but
obfuscates a lot of what is going on in order to provide a consistent interface
to writing your own configuration. You can, if you choose, learn a lot from
=use-package= by simply running it through =macroexpand= and reviewing the result.
To learn more, you can peruse the source code for
[[https://github.com/jwiegley/use-package][use-package]].

*** Reversible

Not everyone will agree with our decisions, so each customization should be
Expand Down

0 comments on commit 5b272e8

Please sign in to comment.