> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nelsonandassociatesinc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# For contributors

> How engineers and coding agents extend these docs.

## App location

```
apps/docs-mintlify/         ← Mintlify site (canonical per ADR-0013)
  docs.json                 ← Mintlify config (required on default branch)
  *.mdx / nested folders    ← public docs content
```

Dev locally:

```bash theme={null}
cd apps/docs-mintlify
npx mint dev
# → http://localhost:3000 (Mintlify default)
```

See `CONNECT.md` in this folder for GitHub App + custom-domain wiring.

## Writing rules

* **Public-safe only.** No phone numbers, producer performance, strategy aliases, or carrier policyholder data.
* Prefer short pages with one job each.
* **Helpful-first:** answer the question in the first screen; CTA second. No fear copy; no unverifiable savings claims.
* **Learn / Guides CTAs** use UTM: `utm_source=docs&utm_medium=referral&utm_campaign=<page_slug>`. Business hours truth: **Mon–Fri 9–5 CT**. Public licensing claim: **19 states** until OR entity is ACTIVE (`packages/ui/src/data/licensed-states.ts`).
* Link to the producer portal or consumer site for actions; do not duplicate runbooks that belong in private `/docs`.
* Keep ADR-0013 (Mintlify), the Docs Demand Engine workstream (`docs/workstreams/docs-demand-engine.md`), and the confidential naming doctrine in mind before naming entities. ADR-0004 (Fumadocs) is superseded for the public docs host.

## Automation

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