diff --git a/core/src/icon.rs b/core/src/icon.rs
index b26e833..e9f5f29 100644
--- a/core/src/icon.rs
+++ b/core/src/icon.rs
@@ -2,7 +2,7 @@
 //!
 //! **Why a bundled font rather than ordinary Unicode**: the disclosure
 //! mark used to be U+25B8/25BE/25B4 out of whatever face the platform
-//! resolved, and once iris stopped bundling fonts (DECISIONS.md,
+//! resolved, and once iris stopped bundling fonts (decided
 //! 2026-09-07) Iris's phone drew an empty box for them and this VM drew a
 //! dot. UI_RULES' answer is not to avoid glyphs but to ship them, which is
 //! also what the Compose app has always done for its icons
diff --git a/core/src/primitive/text.rs b/core/src/primitive/text.rs
index 1bc24e7..74da0e1 100644
--- a/core/src/primitive/text.rs
+++ b/core/src/primitive/text.rs
@@ -18,7 +18,7 @@ use swash::{
 ///
 /// This is the one font bundled here, and it is not a text font: body and
 /// monospace text still come from the platform's own collection
-/// (DECISIONS.md, 2026-09-07). An icon is the opposite case -- a small,
+/// (decided 2026-09-07). An icon is the opposite case -- a small,
 /// closed set of codepoints no system font is guaranteed to have -- which
 /// is the same division the Compose app makes.
 const NERD_ICONS: &[u8] = include_bytes!("../../assets/fonts/nerd_icons.ttf");
@@ -92,7 +92,7 @@ impl Default for TextData {
     /// `SansSerif`/`SystemUi` to `["Roboto Flex", "Roboto", "Noto Sans"]`
     /// and `Monospace` to the platform's `"monospace"` alias; the desktop
     /// build's backend is fontconfig. No font is bundled or registered
-    /// here -- see DECISIONS.md's 2026-09-07 entry for why (matching what
+    /// here -- see the 2026-09-07 decision for why (matching what
     /// the Compose app does: it takes body/monospace text from
     /// `FontFamily.Default`/`FontFamily.Monospace`, i.e. Android's Roboto
     /// and its platform monospace face, and ships no text font of its own,
@@ -137,7 +137,7 @@ fn register_icon_font(font_cx: &mut FontContext) -> Option<String> {
 /// `GenericFamily::Monospace` (confirmed against
 /// `fontique-0.11.1/src/backend/android.rs`'s `SystemFonts::new`, and still
 /// present on `linebender/parley`'s `main` as of 2026-09-07, so there is no
-/// released fix to bump to yet -- see DECISIONS.md's 2026-09-07 entry,
+/// released fix to bump to yet -- see the 2026-09-07 decision,
 /// "Platform fonts," for the full account). Two bugs stack, not one:
 /// `DEFAULT_GENERIC_FAMILIES` looks up the name `"monospace"` *before*
 /// `fonts.xml` is parsed into that same name map, and even after parsing,
diff --git a/examples/message_list.rs b/examples/message_list.rs
index 4b63859..bc14e86 100644
--- a/examples/message_list.rs
+++ b/examples/message_list.rs
@@ -2,7 +2,7 @@
 //! wrapped text, one in twelve carrying a small image, scrollable with the
 //! mouse wheel. Run headless with `iris/run-headless.sh message_list --shot
 //! /tmp/message_list.png` -- there is no display on this machine, so that
-//! is the only way to see it rendered; `run-tests.sh`/`cargo test` never
+//! is the only way to see it rendered; `scripts/run-tests.sh`/`cargo test` never
 //! touch this file.
 //!
 //! Rows alternate two background tints so a screenshot can show the
diff --git a/src/sense.rs b/src/sense.rs
index 2f3f8cf..bc43b82 100644
--- a/src/sense.rs
+++ b/src/sense.rs
@@ -1191,7 +1191,7 @@ pub enum GestureOutcome {
 /// terminal release -- keeps reaching the same widget even after the
 /// finger has moved off whatever hit region first noticed the press. Iris
 /// asked for this to live here rather than in `transcript-ui::Selection`
-/// (2026-09-06, recorded in `IRIS.md`): "dragging should be part of the
+/// (2026-09-06): "dragging should be part of the
 /// default input system ... anything that provides good performance and
 /// can be generalized well is part of iris rather than the app." A caller
 /// still decides what a committed pan or a completed selection *means*
diff --git a/tests/mask_sdf.rs b/tests/mask_sdf.rs
index 11a4670..9c8d615 100644
--- a/tests/mask_sdf.rs
+++ b/tests/mask_sdf.rs
@@ -283,7 +283,7 @@ fn run_shader(gpu: &Gpu, radius: f32) -> Vec<f32> {
 /// longer mapped. libtest runs every `#[test]` on a spawned thread, so a
 /// test that opens and closes an instance segfaults *after* printing its
 /// result, which reads exactly like the test failing. Measured
-/// 2026-09-08 with `rigs/gpu-probe`'s `teardown` bin: it
+/// 2026-09-08 with `scripts/rigs/gpu-probe`'s `teardown` bin: it
 /// needs no wgpu (raw `ash` does it too), no GPU work, and no device --
 /// an instance created and destroyed on a spawned thread is enough, and
 /// keeping any one instance alive is enough to prevent it.