Skip to main content

What Gets Documented

In one line: Review the effect of a change, not its label or size.

CategoryReadersTrigger
Business intent and terminologyDomain owners, analysts, developersChanged meaning, rule, definition or acceptance example
Architecture and ADRsTechnical owners and maintainersChanged boundary, significant decision or constraint
API/integration referenceProviders and consumersChanged schema, behavior, authorization or failure semantics
Operations and recoveryOperators and supportChanged deployment, configuration, support or recovery behavior
Privacy/compliance mappingAccountable qualified ownersChanged intended use, data processing or applicable obligations
User journeys and featuresUsers and business reviewersChanged observable behavior or supported capability
Project stateReturning contributorsUpdated maintained work records, optional repository snapshots and separate runtime evidence

A one-line flag change can alter business behavior. A “bugfix” can change API compatibility. Neither is exempt merely because it is small. When a change has no documentation impact, record the review rationale rather than requiring cosmetic edits.