diff options
| author | Craig Jennings <c@cjennings.net> | 2026-05-04 04:12:18 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-05-04 04:12:18 -0500 |
| commit | b3ef232a486382601b6788f0c1a1edeb3982075d (patch) | |
| tree | adb4d20268be674da7f05f0fe711df0ce73b0583 /tests/test-dev-fkeys--detect-project-type.el | |
| parent | 31c913b26a9725595357f678e7197cc7efcd6c53 (diff) | |
| download | dotemacs-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 'tests/test-dev-fkeys--detect-project-type.el')
0 files changed, 0 insertions, 0 deletions
