Based off https://palantir.quip.com/pzRwAVr1bpzf

Pro-tip: look through the github diff between the previous release to see what's changed. The commit titles should give an outline of what's happened.

• List out, as concretely as possible, any steps users have to take when they upgrade beyond just dumping the dependency.
• Write pseudocode that highlights what code should change and how.

See how a minor change to your commit message style can make a difference. Examples

Have a look at CLI util git-conventional-commits to ensure this conventions and generate changelogs