From c5f34e946013cd3f391dc00c0d3012b35f5d23dd Mon Sep 17 00:00:00 2001 From: alexion Date: Sun, 30 Aug 2026 19:30:31 -0400 Subject: [PATCH] docs: add dotfiles vocabulary --- docs/dictionary.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/dictionary.md b/docs/dictionary.md index 143b044..546ebc0 100644 --- a/docs/dictionary.md +++ b/docs/dictionary.md @@ -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. |