21 lines
861 B
Markdown
21 lines
861 B
Markdown
---
|
||
date: 2025-07-28
|
||
title: A CHANGLOG isn't just a list of Git commits
|
||
permalink: /daily/2025/07/28/changlog-isnt-just-list-git-commits
|
||
---
|
||
|
||
Yesterday, I wrote about [keeping a CHANGELOG][0] for software projects, and about the <https://keepachangelog.com> project.
|
||
|
||
I like this slogan on their website:
|
||
|
||
> Don’t let your friends dump git logs into changelogs.
|
||
|
||
A CHANGELOG shouldn't be a list of Git commits in a file.
|
||
|
||
It should be in a human-readable format that's easy for people to read and understand, whether they are technical or not.
|
||
|
||
This probably isn't the case for the output from `git log`, which may also contain commits like `Refactor` and `wip` that don't mean anything to someone who focused on the higher-level deliverables.
|
||
|
||
Git logs are great for Developers, but CHANGELOGs are for everyone.
|
||
|
||
[0]: /daily/2025/07/27/do-you-keep-changelog
|