syl20bnr / spacemacs

A community-driven Emacs distribution - The best editor is neither Emacs nor Vim, it's Emacs *and* Vim!
http://spacemacs.org
GNU General Public License v3.0
23.56k stars 4.9k forks source link

Update documentation for layer dependencies declaration #16406

Closed 2ynn closed 1 month ago

2ynn commented 1 month ago

I think users interested in writing their first configuration layer should be incentivized to use the configuration-layer/declare-layer-dependencies function instead of manually declaring a single layer.

As I was going through the LAYERS.org documentation I noticed most existing layers made use of configuration-layer/declare-layer-dependencies in their layers.el file, instead of the recommended configuration-layer/declare-layer. This seems to be consistent with the configuration-layer/declare-dependencies docstring as well as this comment which suggests declaring layers right away should only be done in special cases by distribution layers.