summaryrefslogtreecommitdiff
path: root/modules/diff-config.el
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-05-04 04:12:18 -0500
committerCraig Jennings <c@cjennings.net>2026-05-04 04:12:18 -0500
commitb3ef232a486382601b6788f0c1a1edeb3982075d (patch)
treeadb4d20268be674da7f05f0fe711df0ce73b0583 /modules/diff-config.el
parent31c913b26a9725595357f678e7197cc7efcd6c53 (diff)
downloaddotemacs-b3ef232a486382601b6788f0c1a1edeb3982075d.tar.gz
dotemacs-b3ef232a486382601b6788f0c1a1edeb3982075d.zip
docs: add init.el load-graph and utility-consolidation specs
I added two sibling design specs in `docs/design/`: `init-load-graph.org` covers untangling `init.el` from its current "everything eager in a fixed order" shape. It defines a layered architecture (early-init / foundation / core UX / domain workflow / optional), a module category table for every required file, a per-file commentary header standard with seven required lines, a six-phase migration plan with exit criteria, and a testing strategy split into automated batch checks, manual smoke checks, and startup performance baselines via `benchmark-init`. `utility-consolidation.org` is the sibling project. It covers extracting reusable helpers from feature modules into `system-lib.el` and a small set of topic libraries (`cj-process.el`, `cj-org-text.el`, `cj-cache.el`). It includes a candidate decision criteria section, a library file header standard with worked example, a candidate extraction table with priorities and proposed names, nine helper groups with API plus behavior contracts, naming rules, migration phases, test relocation policy, and a recommended first-three-commits sequence. Both specs are draft. No code change in this commit. The two projects are intentionally separated because the load-graph project asks "when does this load?" and the consolidation project asks "who owns this helper?". Those are different questions with different rollback shapes. Implementation tracking lives in `todo.org`.
Diffstat (limited to 'modules/diff-config.el')
0 files changed, 0 insertions, 0 deletions