aboutsummaryrefslogtreecommitdiff
path: root/tests
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-06-15 10:24:40 -0500
committerCraig Jennings <c@cjennings.net>2026-06-15 10:24:40 -0500
commit45e0f6e896b2c34de25d5c3aa18474c79d6a1e72 (patch)
tree3f4d822aa5da53f4e6bbebbdc7fb400a2b212189 /tests
parenta5c9f48220cd52770f10f7627922b9fc8e2204cc (diff)
downloaddotemacs-45e0f6e896b2c34de25d5c3aa18474c79d6a1e72.tar.gz
dotemacs-45e0f6e896b2c34de25d5c3aa18474c79d6a1e72.zip
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/.
Diffstat (limited to 'tests')
-rw-r--r--tests/run-coverage-file.el2
-rw-r--r--tests/test-cj-cache-lib.el2
-rw-r--r--tests/test-init-module-headers.el2
-rw-r--r--tests/test-modeline-config-flycheck-segment.el2
-rw-r--r--tests/test-signal-config-notify.el2
-rw-r--r--tests/test-signel-notify-function.el2
6 files changed, 6 insertions, 6 deletions
diff --git a/tests/run-coverage-file.el b/tests/run-coverage-file.el
index 6ac65300b..0d96f1918 100644
--- a/tests/run-coverage-file.el
+++ b/tests/run-coverage-file.el
@@ -9,7 +9,7 @@
;; Per-file isolation matches the project's `make test-unit' pattern:
;; each test file runs in its own Emacs process, so tests that work
;; under `make test' will also work under `make coverage'. See
-;; docs/design/coverage.org for the rationale.
+;; docs/specs/coverage-spec-implemented.org for the rationale.
;;; Code:
diff --git a/tests/test-cj-cache-lib.el b/tests/test-cj-cache-lib.el
index aeb329dda..7de7edb8c 100644
--- a/tests/test-cj-cache-lib.el
+++ b/tests/test-cj-cache-lib.el
@@ -4,7 +4,7 @@
;; Unit tests for the TTL+building cache helper. Covers cache-make /
;; cache-valid-p / cache-value-or-rebuild / cache-building-p /
;; cache-invalidate against the contract in
-;; docs/design/cache-helper-design.org.
+;; docs/specs/cache-helper-design-spec-implemented.org.
;;; Code:
diff --git a/tests/test-init-module-headers.el b/tests/test-init-module-headers.el
index bbda23887..a5b331f4d 100644
--- a/tests/test-init-module-headers.el
+++ b/tests/test-init-module-headers.el
@@ -2,7 +2,7 @@
;;; Commentary:
;; Enforces the module load-graph header standard from
-;; docs/design/init-load-graph.org against every module that has been
+;; docs/specs/init-load-graph-spec-doing.org against every module that has been
;; classified so far. Classification proceeds in batches; a module joins
;; `test-init-header--classified-modules' once its header declares the
;; contract. When that list reaches parity with the modules required by
diff --git a/tests/test-modeline-config-flycheck-segment.el b/tests/test-modeline-config-flycheck-segment.el
index 208deaa72..2ae2f5de1 100644
--- a/tests/test-modeline-config-flycheck-segment.el
+++ b/tests/test-modeline-config-flycheck-segment.el
@@ -5,7 +5,7 @@
;; a guarded reference to `flycheck-mode-line-status-text', and that
;; the guard requires both `mode-line-window-selected-p' and
;; `bound-and-true-p flycheck-mode'. See
-;; docs/design/flycheck-modeline-customization.org for the design.
+;; docs/specs/flycheck-modeline-customization-spec-implemented.org for the design.
;;; Code:
diff --git a/tests/test-signal-config-notify.el b/tests/test-signal-config-notify.el
index c4067a663..1a7722893 100644
--- a/tests/test-signal-config-notify.el
+++ b/tests/test-signal-config-notify.el
@@ -6,7 +6,7 @@
;; `cj/signal--notify-body-max') and `cj/signel--notify' routing (the
;; suppression gate, the notify-script path with the sound flag, and
;; the `notifications-notify' fallback). Spec: the "Notification
-;; slice" addendum in docs/design/signal-client.org. No signal-cli or
+;; slice" addendum in docs/specs/signal-client-spec-doing.org. No signal-cli or
;; linked account needed.
;;; Code:
diff --git a/tests/test-signel-notify-function.el b/tests/test-signel-notify-function.el
index cff7f7394..e3d97af51 100644
--- a/tests/test-signel-notify-function.el
+++ b/tests/test-signel-notify-function.el
@@ -3,7 +3,7 @@
;;; Commentary:
;; signel's receive handler (signel.el in the fork at ~/code/signel)
;; raised notifications through a hardwired `notifications-notify'
-;; call. The notification slice (docs/design/signal-client.org,
+;; call. The notification slice (docs/specs/signal-client-spec-doing.org,
;; "Notification slice" addendum) replaces that with
;; `signel-notify-function', a customization point called with
;; CHAT-ID, SENDER, and BODY so a config layer can add suppression or