docs: promote API docs to own section with live analyzer.00id.net links, fix transition section

docs/release-notes/v3.5.0.md

@@ -41,11 +41,12 @@ docker stop <container-name> && docker rm <container-name>
 docker pull ghcr.io/kpa-clawbot/corescope:v3.5.0
 
 # 4. Run with your existing data directory
-docker run -d --name corescope -p 80:80 -p 1883:1883 \
-  -v /path/to/your/data:/app/data \
-  ghcr.io/kpa-clawbot/corescope:latest
+docker run -d --name corescope -p 80:80 -p 443:443 -p 1883:1883 \
+  -v /your/data:/app/data \
+  -v /your/Caddyfile:/etc/caddy/Caddyfile:ro \
+  -v /your/caddy-data:/data/caddy \
+  ghcr.io/kpa-clawbot/corescope:v3.5.0
 ```
-Your data volume stays. No git clone needed anymore.
 Your data volume stays. Nothing to migrate.
 
 Tags: `v3.5.0` (this release) · `latest` (latest tagged release) · `edge` (master tip, for testing). Env: `DISABLE_CADDY=true` / `DISABLE_MOSQUITTO=true` if you bring your own.
@@ -89,12 +90,21 @@ Send a trace → watch it on the live map. Solid animated line shows how far it
 
 **Mobile** — 44px touch targets, ARIA labels, responsive breakpoints.
 
-**API docs** — Swagger UI at `/api/docs`, OpenAPI spec at `/api/spec`. Auto-generated, always current.
-
 **Security** — weak API keys rejected at startup. License: GPL v3.
 
 ---
 
+## 📡 Full API Documentation
+
+Every endpoint is now documented with an auto-generated OpenAPI 3.0 spec — always in sync with the running server.
+
+- **Interactive Swagger UI:** [analyzer.00id.net/api/docs](https://analyzer.00id.net/api/docs) — browse and test all 40+ endpoints
+- **Machine-readable spec:** [analyzer.00id.net/api/spec](https://analyzer.00id.net/api/spec) — import into Postman, Insomnia, or use for bot/integration development
+
+On your own instance: `/api/docs` and `/api/spec`.
+
+---
+
 ## 🐛 14 Bugs Squashed
 
 Live map crash, zero-hop hash lies, animation freezes, repeater miscounts, prefix collisions, dead channel picker, invisible buttons, broken sorting, memory leak, and more.