diff --git a/README.md b/README.md
index 2d195c8..e29116f 100644
--- a/README.md
+++ b/README.md
@@ -18,7 +18,7 @@ Hardware characterization, the serial core, session broker, and native USB CDC-A
 
 ## Documentation
 
-- [Hardware wiring](wiring.md): hardware profile, GPIO assignments, connector guidance, and safety notes.
+- [Hardware wiring](docs/wiring.md): hardware profile, GPIO assignments, connector guidance, and safety notes.
 - [Electrical tests](docs/electrical_tests.md): MAX3243, UART loopback, and session-broker verification procedures.
 - [Command reference](docs/command_reference.md): UART0 administration, serial, broker, USB, Wi-Fi, web, SSH, and diagnostic commands.
 
diff --git a/wiring.md b/docs/wiring.md
similarity index 97%
rename from wiring.md
rename to docs/wiring.md
index 4d296d5..7e5dc8c 100644
--- a/wiring.md
+++ b/docs/wiring.md
@@ -102,7 +102,7 @@ Native USB CDC DTR controls the lifetime of the `usb-cdc` broker client but is n
 
 ## Electrical verification
 
-See [Electrical tests](docs/electrical_tests.md) for safe loopback wiring, polarity checks, UART flow-control verification, and session-broker loopback testing.
+See [Electrical tests](electrical_tests.md) for safe loopback wiring, polarity checks, UART flow-control verification, and session-broker loopback testing.
 
 ## Future hardware profiles