For contributors

App location

apps/docs/                  ← Fumadocs (Next.js 16) site
  content/docs/             ← MDX source of truth for this subdomain
  app/                      ← routes, search API

Dev locally:

pnpm --filter @nelson/docs dev
# → http://localhost:3002/docs

Writing rules

• Public-safe only. No phone numbers, producer performance, strategy aliases, or carrier policyholder data.
• Prefer short pages with one job each.
• Link to the producer portal or consumer site for actions; do not duplicate runbooks that belong in private /docs.
• Keep ADR-0004 (Fumadocs) and the confidential naming doctrine in mind before naming entities.

Automation

The Cursor Generate docs automation can open PRs that update apps/docs/content/docs. Treat those PRs like any other code review — merge only public-safe, accurate content.