# ADR 0004: Generate Source And API Reference

## Status

Accepted.

## Decision

Use generated Markdown references for exhaustive source, line, and API coverage, and use curated docs for concepts, workflows, architecture, and operations.

## Context

The repository has more than one hundred thousand source lines. Literal line-by-line source comments would reduce maintainability and make reviews noisy.

## Consequences

- Every tracked source line is linked from `docs/reference/generated/source/`.
- Public package APIs are generated with TypeDoc Markdown.
- Source comments are reserved for exported boundaries and complex internal behavior.
- Generated docs must be rebuilt and checked after source changes.
