config : host-overrides
Currently an in-progress migration from the name "local" to "host-overrides."
I recently identified the need for a distinction between "a machine-distinct setting" which should still be tracked and a "one-off hack, or temporary local detail" which is NOT tracked.
The new general configuration hierarchy, from most general to highest precedence, is then:
- The primary application configuration (e.g.
config/userorconfig/etcin this repository) - The host-level overrides / additions (e.g. this folder)
- The local overrides
Migration Notes
Where possible, it's better to use a unique, descriptive name, but in some situations we have a clear hierarchy linked within a specific application's configuration folder.
Old files tend to be called or linked to places with the name "local.{extension}," but new files in this directory should now prefer the terminology host.
For example:
# OLD NAME -> NEW NAME
pikachu/user/alacritty/local.toml -> pikachu/user/alacritty/host.toml