aboutsummaryrefslogtreecommitdiff
path: root/docs/specs/2026-07-19-display-format-single-source-of-truth-spec.org
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-07-19 23:45:24 -0500
committerCraig Jennings <c@cjennings.net>2026-07-19 23:45:24 -0500
commit0468fedb23ae34a140b6a5a903adedb4e9873ca5 (patch)
tree188151ac2e0e9a27b205cd523c7872028795e5ca /docs/specs/2026-07-19-display-format-single-source-of-truth-spec.org
parentc4b3710b14a47d4c8297322297f217be264349ea (diff)
downloadarchsetup-0468fedb23ae34a140b6a5a903adedb4e9873ca5.tar.gz
archsetup-0468fedb23ae34a140b6a5a903adedb4e9873ca5.zip
docs: expand desktop-settings spec and add panel prototypes
I folded the home-handoff control-set decisions into the desktop-settings panel spec. The controls table gains night-light, Do Not Disturb, power profile, lock/suspend actions, scenes, and a wallpaper sub-view. Volume and theme are out of scope, with reasons, and the format pickers move to their own display-format sibling spec (stubbed). The scenes and wallpaper-shape decisions close. The spec stays DRAFT pending UI prototyping. I added five direction prototypes over a shared engine (tile grid, sectioned rack, scenes-first, instrument cluster, expandable rows) so the layout gets picked against working behavior. I closed the shipped Next Session Focus work in todo.org: notification loudness, clock right-click dismiss, date-only scrolling, the wired-interface indicator, and best-saved WiFi connect, plus velox boot recovery. The three design-blocked network and audio items stay TODO with their open question recorded.
Diffstat (limited to 'docs/specs/2026-07-19-display-format-single-source-of-truth-spec.org')
-rw-r--r--docs/specs/2026-07-19-display-format-single-source-of-truth-spec.org63
1 files changed, 63 insertions, 0 deletions
diff --git a/docs/specs/2026-07-19-display-format-single-source-of-truth-spec.org b/docs/specs/2026-07-19-display-format-single-source-of-truth-spec.org
new file mode 100644
index 0000000..02e043c
--- /dev/null
+++ b/docs/specs/2026-07-19-display-format-single-source-of-truth-spec.org
@@ -0,0 +1,63 @@
+#+TITLE: Display-Format Single Source of Truth
+#+AUTHOR: Craig Jennings
+#+DATE: 2026-07-19
+#+TODO: TODO | DONE
+#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED
+
+* DRAFT Display-Format Single Source of Truth
+:PROPERTIES:
+:ID: ae247f1a-e48f-4d5e-8556-dd1f0aa34a69
+:END:
+- [2026-07-19 Sun] DRAFT — stub. Split out of the desktop-settings panel spec (Craig, 2026-07-19): format pickers do not belong in that panel. Filed to hold the problem until it gets its own design pass. Not started.
+
+* Status
+:PROPERTIES:
+:ID: a76a41df-85c2-4137-9ba5-eff04db529a5
+:END:
+- [2026-07-19 Sun] DRAFT — stub only. Problem framed below; goals, decisions, and phases to be developed when Craig picks this up.
+
+* Metadata
+
+| Field | Value |
+|--------+-----------------------------------------|
+| Status | draft |
+|--------+-----------------------------------------|
+| Owner | Craig Jennings |
+|--------+-----------------------------------------|
+| Repo | dotfiles |
+|--------+-----------------------------------------|
+| Kin | desktop-settings panel (parent), clock |
+| | module, weather chip (consumers) |
+|--------+-----------------------------------------|
+
+* Problem
+
+Display-format settings for time, date, and weather are stored independently by
+each program that renders them. The clock module has its own format ring, the
+weather chip its own, and any future consumer would carry a third. There is no
+canonical place a user sets "this is how I want the time shown" that every
+surface reads.
+
+The design problem is a single source of truth: where the canonical
+time/date/weather format lives, and how every consumer reads it without drift.
+Solve that first; the pickers (the UI that edits the format) are downstream of
+where the value is stored.
+
+This was pulled out of the desktop-settings panel spec
+([[file:2026-07-02-desktop-settings-panel-spec.org][desktop-settings panel]]) on
+2026-07-19 — format editing does not belong in that panel, and the real work is
+the storage/consumption model, not a picker widget.
+
+* Goals
+
+(To be developed. At minimum: a canonical store for time/date/weather format; a
+read path every consumer uses; a migration for the existing per-consumer
+formats.)
+
+* Decisions
+
+(None yet — Craig has not started this.)
+
+* Implementation phases
+
+(To be developed once the goals and the storage model are settled.)