docs: architecture system-context diagram says :8229 where production default is :8228 #530

New issue

Closed

opened 2026-08-20 02:54:59 +02:00 by dries · 0 comments

dries commented

2026-08-20 02:54:59 +02:00

Owner

Found during review of PR #521 (docs: plainer prose). Pre-existing; left out of that PR because it was outside the diff.

docs/other/architecture.md (~line 47): the system-context Mermaid diagram labels the ocman binary as :8229. That is the dev backend port (air, behind the Vite proxy); the production -addr default is 127.0.0.1:8228 (main.go). PR #521 already fixed the same confusion in docs/features/mcp.md (commit 61fbde29), so the diagram is now the last place with the dev-centric port.

Fix: label the diagram :8228 (production default), optionally noting :8229 as the dev backend. Per AGENTS.md, update the bullet list under the diagram in the same change if it repeats the port.

Found during review of PR #521 (docs: plainer prose). **Pre-existing**; left out of that PR because it was outside the diff. `docs/other/architecture.md` (~line 47): the system-context Mermaid diagram labels the ocman binary as `:8229`. That is the dev backend port (air, behind the Vite proxy); the production `-addr` default is `127.0.0.1:8228` (`main.go`). PR #521 already fixed the same confusion in `docs/features/mcp.md` (commit 61fbde29), so the diagram is now the last place with the dev-centric port. Fix: label the diagram `:8228` (production default), optionally noting `:8229` as the dev backend. Per AGENTS.md, update the bullet list under the diagram in the same change if it repeats the port.