docs: add dotfiles vocabulary

This commit is contained in:
2026-08-30 19:30:31 -04:00
parent 8aba9b65c5
commit c5f34e9460

View File

@@ -32,3 +32,15 @@ Use `REPLACE` for terms that have a preferred substitute.
| `really` | AVOID | | Empty intensifier. |
| `furthermore` / `moreover` | REPLACE | `also`, `and` | Overly formal transitional filler. |
| repository root | USE | | The Git work tree root. Use it to resolve repository-relative paths. |
| agent | USE | | An AI coding assistant acting in the operator's environment. |
| operator | USE | | The human driving the development process. Use when distinguishing the human from the agent acting on their behalf. |
| guest | USE | | A systemd-nspawn container managed by the NixOS configuration. |
| host | USE | | A machine with a NixOS configuration built by this repository's flake. |
| module | USE | | A self-contained NixOS configuration under `configs/nixos/modules/`. |
| registry | USE | | A typed configuration namespace whose entries can be collected across hosts and reused by other configuration. |
| Conventional Commits | USE | | A commit-message format defined in `docs/conventional-commits.md`. |
| forge | USE | | A web service that hosts Git repositories, pull requests, issues, and code review comments. Use when the exact provider does not matter. |
| flake | USE | | A Nix project with pinned inputs and declared outputs. Use for the repository-level build unit defined by `flake.nix`. |
| NixOS module | USE | | A Nix file evaluated by `nixosSystem` for a NixOS configuration. |
| overlay | USE | | A function that modifies a Nix package set by adding or replacing packages. |
| workspace | USE | | A named or numbered group of windows in a graphical session. Some desktop environments call this a virtual desktop. |