14 · Shipping & Collaboration

Changelog

What changed between versions

A human-readable list of notable changes in a release—features, fixes, and breaking changes. Distinct from the raw git log.

Concrete example

Readers skim the changelog before upgrading a dependency.

Why it matters

How humans decide whether an upgrade is safe.