diff --git a/RELEASE.md b/RELEASE.md
index 59f040fad..abd33a5c2 100644
--- a/RELEASE.md
+++ b/RELEASE.md
@@ -1,7 +1,7 @@
 # Releasing Firmware
 
 For the USA Cascade 1.17.1.5 matrix, use
-[the option 3 release instructions](docs/releases/1.17.1.5.md).
+[the option 3 release instructions](docs/old-releases/1.17.1.5.md).
 Package the qualified outputs with `scripts/package_cascade_release.py`.
 Local staging does not publish or push anything. Include the
 [feature switches by role](docs/role_feature_switches.md),
diff --git a/scripts/check_firmware_ram.py b/scripts/check_firmware_ram.py
index 83d4d2c4f..5a4b68efb 100644
--- a/scripts/check_firmware_ram.py
+++ b/scripts/check_firmware_ram.py
@@ -4,7 +4,7 @@
 Uses real linker heap bounds on ARM and the linked ESP-IDF allocator tables on
 ESP32. These are capacity checks before dynamic allocation, not hardware soak
 results. PSRAM, instruction-only RAM and reserved bootloader arenas never count
-as internal heap. See docs/firmware_memory_budget.md for the budget policy.
+as internal heap. See docs/research/firmware_memory_budget.md for the budget policy.
 """
 
 from __future__ import annotations
diff --git a/test/test_logging_sleep_contract.py b/test/test_logging_sleep_contract.py
index 1be72449e..b2fcbf394 100644
--- a/test/test_logging_sleep_contract.py
+++ b/test/test_logging_sleep_contract.py
@@ -103,7 +103,7 @@ class LoggingSleepContractTest(unittest.TestCase):
         for path in (
             "docs/cli_commands.md", "docs/role_feature_switches.md",
             "docs/full_companion_features.md", "docs/companion_radio_full.md",
-            "docs/firmware_picker.md", "docs/releases/1.17.1.5.md",
+            "docs/firmware_picker.md", "docs/old-releases/1.17.1.5.md",
         ):
             with self.subTest(path=path):
                 text = (ROOT / path).read_text(encoding="utf-8")
@@ -114,7 +114,7 @@ class LoggingSleepContractTest(unittest.TestCase):
 
     def test_wifi_exception_is_documented_with_running_state_check(self):
         for path in ("docs/cli_commands.md", "docs/role_feature_switches.md",
-                     "docs/releases/1.17.1.5.md"):
+                     "docs/old-releases/1.17.1.5.md"):
             with self.subTest(path=path):
                 text = (ROOT / path).read_text(encoding="utf-8")
                 paragraphs = [