Developer Reference Fumadocs section

Status: Resolved as a setup task — contributor reference pages are live under /reference/getting-oriented/ and /reference/developer-reference/; future work is ordinary reference maintenance, not a standalone roadmap implementation item

Current shape

The contributor-facing reference did not land under /internal/. The current orientation route is /reference/getting-oriented/, with architecture, codebase-map, and workspace automation pages under that tree. Behavioral specs live under /reference/developer-reference/specs/; deeper research and design material live under the broader /reference/ and /roadmap/ contributor surfaces.

This item is no longer about creating an /internal/ route or bootstrapping the contributor section. It is about keeping contributor references complete as code shifts.

Remaining work

1. Expand stubby contributor pages only when there is durable content to publish.
2. Keep behavioral specs in reference pages once they become durable contracts; keep transient task checklists in roadmap pages.
3. Verify docs with bun run build, cargo xtask docs repo-links, and cargo xtask roadmap audit when routes change.

Canonical routes

• Architecture
• Codebase Map
• Behavioral Specs
• Roadmap Overview