docs(install): stitch the README → template first-run handoff — item 6 complete
All checks were successful
Check / eval (push) Successful in 2m55s
All checks were successful
Check / eval (push) Successful in 2m55s
Slice (c), the last of the docs review: the install/first-run story read end to end against the tree. Facts held (mkFlake args match the table, disko's @snapshots + hibernation swapfile, .#default/.#me naming); the one seam — README §3 never pointed the manual path at the template README's first-run steps — got a connective paragraph. Item 6 deleted from BACKLOG; ROADMAP § Full docs review flipped to ✓. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
@@ -17,6 +17,24 @@ Template:
|
||||
|
||||
---
|
||||
|
||||
## 2026-07-04 — docs slice (c): install story — item 6 COMPLETE (iteration #16)
|
||||
- **Task:** BACKLOG NOW#6 slice (c), the last one — install/first-run
|
||||
narrative end to end.
|
||||
- **Did:** read README §2 (ISO/installer) → §3 (downstream) → template
|
||||
README as one story; checked the facts en route: mkFlake's arg
|
||||
surface == the §3 table (src/username/hardwareProfile/system, lib.nix),
|
||||
disko really makes @snapshots + the hibernation swapfile, .#default /
|
||||
.#me names consistent. One seam fixed: §3 showed `nix flake init -t`
|
||||
but never handed off to the template README's six first-run steps —
|
||||
connective paragraph added (+ "the installer does all of this").
|
||||
Item 6 done → deleted from BACKLOG (NOW now empty); ROADMAP § Full
|
||||
docs review flipped to ✓ with the slice summary.
|
||||
- **Verified:** V0 (docs-only) — flake check clean pre-commit.
|
||||
- **Pending:** docs-site-vs-Markdown stays a Decision.
|
||||
- **Next suggestion:** NEXT#8 (viewers + mime defaults) is the new queue
|
||||
head; note its "Default browser" Decision dependency — the mime module
|
||||
half can proceed with mkDefault degradation regardless.
|
||||
|
||||
## 2026-07-04 — docs slice (d): recovery runbook (iteration #15, item 6d)
|
||||
- **Task:** BACKLOG NOW#6 slice (d) — write the undo story.
|
||||
- **Did:** docs/RECOVERY.md, symptom-ordered: (1) bad theme/HM change →
|
||||
|
||||
Reference in New Issue
Block a user