Writing Release Notes & Changelog This repo maintains two release artifacts that describe the same set of changes for different audiences: | File | Audience | Tone | Length | |---|---|---|---| | | Product owners, operators, developers shipping the system | Narrative, benefit-first with technical depth | Detailed | | | Developers integrating against the APIs, auditors, release engineers | Terse, factual, PR-linked (Keep a Changelog format) | Compact | Both files are updated in the same release pass from the same source of commits. The narrative in may group and re-order changes thematically; p…