From 45e0f6e896b2c34de25d5c3aa18474c79d6a1e72 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Mon, 15 Jun 2026 10:24:40 -0500 Subject: docs: move specs to docs/specs/ with lifecycle-status filenames Separate the 27 formal specs from working notes. Specs move to docs/specs/, notes stay in docs/design/. Each spec carries its lifecycle in the filename (-spec, -spec-doing, -spec-implemented, -spec-superseded) plus an authoritative ID and STATUS property drawer. The status came from checking each spec against the code, not the doc's own field: 6 implemented, 8 in progress, 12 not started, 1 superseded. Inbound links become org-id links so future status renames don't break them; code-comment paths repoint to docs/specs/. Working notes, inventories, reviews, and brainstorms stay in docs/design/. --- scripts/theme-studio/build-theme.el | 2 +- scripts/theme-studio/theme-coloring-guide.org | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) (limited to 'scripts') diff --git a/scripts/theme-studio/build-theme.el b/scripts/theme-studio/build-theme.el index 827129976..f7cd127d1 100644 --- a/scripts/theme-studio/build-theme.el +++ b/scripts/theme-studio/build-theme.el @@ -6,7 +6,7 @@ ;; The last link in the theme-studio pipeline: turn a theme.json exported by ;; the tool (see scripts/theme-studio/README.md and -;; docs/design/theme-studio-package-faces-spec.org) into a single, +;; docs/specs/theme-studio-package-faces-spec-doing.org) into a single, ;; self-contained, loadable Emacs deftheme written to themes/-theme.el. ;; ;; Four tiers come out of the JSON: diff --git a/scripts/theme-studio/theme-coloring-guide.org b/scripts/theme-studio/theme-coloring-guide.org index 170ad7089..cfeeb3372 100644 --- a/scripts/theme-studio/theme-coloring-guide.org +++ b/scripts/theme-studio/theme-coloring-guide.org @@ -433,7 +433,7 @@ The tool is where the rules get applied, by eye and increasingly by metric. Contrast Algorithm, [[https://github.com/Myndex/apca-w3][Myndex]]), and pairwise ΔE (perceptual color-difference) diagnostics make "use chroma to express salience" and "low contrast does not mean low distinguishability" checkable instead of eyeballed. See - [[file:../../docs/design/theme-studio-perceptual-color-metrics-spec.org][docs/design/theme-studio-perceptual-color-metrics-spec.org]]. + [[id:15db8ae3-fc14-49f3-9ed5-d5ff59790904][docs/specs/theme-studio-perceptual-color-metrics-spec-implemented.org]]. - *Seeding:* the seed table is the contract the tool seeds from: syntax, UI, and org tiers each start from guide-correct defaults, leaving you to retune hues rather than build a theme from blank. -- cgit v1.2.3