docs: replace code-formatted doc paths with markdown links

docs/02-quickstart.md

@@ -11,4 +11,4 @@ After `docker compose up`:
 
 ## Common gotchas
 - `NEXT_PUBLIC_API_URL` must be reachable from your browser (host), not just from inside Docker.
-- Clerk auth is required; ensure Clerk keys are configured (see `docs/deployment/README.md`).
+- Clerk auth is required; ensure Clerk keys are configured (see [Deployment guide](deployment/README.md)).

docs/05-architecture.md

@@ -82,7 +82,7 @@ Notes:
 Mission Control can coordinate with OpenClaw Gateways over WebSockets.
 
 - Protocol methods/events list: `backend/app/services/openclaw/gateway_rpc.py`.
-- Operator-facing protocol docs: `docs/openclaw_gateway_ws.md`.
+- Operator-facing protocol docs: [Gateway WebSocket protocol](openclaw_gateway_ws.md).
 
 ## Where to start reading code
 

docs/10-troubleshooting.md

@@ -14,11 +14,11 @@ This is the “quick triage” page. For detailed playbooks and diagnostics, use
 
 ### Frontend keeps redirecting / Clerk errors
 - Verify your Clerk keys are set correctly in the frontend environment.
-- See: `docs/deployment/README.md` (Clerk auth notes).
+- See: [Deployment guide](deployment/README.md) (Clerk auth notes).
 
 ### Backend returns 5xx
 - Check DB connectivity (`DATABASE_URL`) and migrations.
 - Check backend logs.
 
 ## Next
-- Promote the most common issues from `docs/troubleshooting/README.md` into this page once we see repeated incidents.
+- Promote the most common issues from [Troubleshooting deep dive](troubleshooting/README.md) into this page once we see repeated incidents.

docs/11-contributing.md

@@ -12,7 +12,7 @@
 
 ## Adding/changing docs
 - Canonical docs live in `docs/`.
-- Follow the IA in `docs/README.md`.
+- Follow the IA in [Docs landing](README.md).
 
 ## Testing expectations
 - See [docs/testing/README.md](testing/README.md).

docs/README.md

@@ -24,11 +24,11 @@ This folder is the canonical documentation set for Mission Control.
 
 ## Existing deep-dive docs
 
-Some deeper docs already exist under `docs/**` directories; the IA pages above link to them where appropriate:
-- `docs/architecture/README.md`
-- `docs/deployment/README.md`
-- `docs/production/README.md`
-- `docs/testing/README.md`
-- `docs/troubleshooting/README.md`
-- `docs/openclaw_gateway_ws.md`
-- `docs/openclaw_gateway_base_config.md`
+These deeper references already exist under `docs/` directories:
+- [Architecture deep dive](architecture/README.md)
+- [Deployment guide](deployment/README.md)
+- [Production notes](production/README.md)
+- [Testing guide](testing/README.md)
+- [Troubleshooting](troubleshooting/README.md)
+- [Gateway WebSocket protocol](openclaw_gateway_ws.md)
+- [Gateway base config](openclaw_gateway_base_config.md)

docs/architecture/README.md

@@ -54,8 +54,8 @@ flowchart LR
 ### Gateway integration (optional)
 Mission Control can call into an OpenClaw Gateway over WebSockets.
 - Client + protocol: `backend/app/services/openclaw/gateway_rpc.py`
-- Protocol doc: `docs/openclaw_gateway_ws.md`
-- Base gateway config (getting started): `docs/openclaw_gateway_base_config.md`
+- Protocol doc: [Gateway WebSocket protocol](../openclaw_gateway_ws.md)
+- Base gateway config (getting started): [Gateway base config](../openclaw_gateway_base_config.md)
 
 ## Request flows
 
@@ -110,9 +110,9 @@ Frontend:
 
 ## Related docs
 - Self-host (Docker Compose): see repo root README: [Quick start (self-host with Docker Compose)](../../README.md#quick-start-self-host-with-docker-compose)
-- Production-ish deployment: [`docs/production/README.md`](../production/README.md)
-- Testing (Cypress/Clerk): [`docs/testing/README.md`](../testing/README.md)
-- Troubleshooting: [`docs/troubleshooting/README.md`](../troubleshooting/README.md)
+- Production-ish deployment: [Production notes](../production/README.md)
+- Testing (Cypress/Clerk): [Testing guide](../testing/README.md)
+- Troubleshooting: [Troubleshooting](../troubleshooting/README.md)
 
 ## Notes / gotchas
 - Mermaid rendering depends on the markdown renderer.

docs/openclaw_gateway_base_config.md

@@ -3,8 +3,8 @@
 This document explains a "base" OpenClaw Gateway config intended for local development and LAN use, and how to connect it to Mission Control.
 
 Related:
-- Gateway WebSocket protocol: `docs/openclaw_gateway_ws.md` (default URL `ws://127.0.0.1:18789`)
-- Mission Control architecture (gateway integration): `docs/architecture/README.md`
+- Gateway WebSocket protocol: [Gateway WebSocket protocol](openclaw_gateway_ws.md) (default URL `ws://127.0.0.1:18789`)
+- Mission Control architecture (gateway integration): [Architecture deep dive](architecture/README.md)
 
 ## Who This Is For
 

docs/testing/README.md

@@ -30,7 +30,7 @@ Implementation in this repo:
   - `cy.clerkLoaded()`
   - `cy.clerkSignIn(...)` / `cy.clerkSignOut(...)`
 
-See also: [`docs/e2e-auth.md`](../e2e-auth.md).
+See also: [E2E auth notes](../e2e-auth.md).
 
 ### Test user (non-secret)