Changelog philosophy
Briefly

"It's easy to publish a list of commits or pull requests and call it a changelog, but it's not that helpful to your users trying to understand what has changed for them."
"Release notes can include project-level information that doesn't correspond to a particular change in a release - maybe you started a new discussion forum or there's a shift in maintainer attention."
"If the release notes are user-focused, then the changelog can be more comprehensive, giving people a fuller picture of the work that goes into producing the project."
"My problem with separating the changelog and release notes is that I have limited energy to produce them, and people have limited attention to read them."
Read at Nedbatchelder
[
|
]