HN Hall of Fame Weekly email

Keep a Changelog

keepachangelog.com Reference Standards & specifications Software engineering Candidate
Screenshot of keepachangelog.com captured 2026-07-20
Page preview · captured 2026-07-20

Resurfaced independently across 5 calendar years, with breakout response in 3 of them.

submissions
6
submitters
6
observed span
2014–2021
peak thread · 71 comments
275 pts
latest 20+ return · 2018-07-28
275 pts

Submission timeline

2007–2026

One slot for every year since HN launched. Height is that year's peak points; orange marks a 100+ point or 50+ comment breakout. Select a bar to open its strongest thread.

First comments on top threads

HN comment order

I think (a good) changelog is especially important when it comes to closed-source software where you don’t have the opportunity to downgrade easily (from Windows software to mobile applications). For example if you visit the App Store now, you’ll see the many app developers, especially the big ones such as Twitter, Facebook etc., are using the same changelog entry for every, single, update: “Thanks for using X! To make our app better for you, we bring updates to the App…

Projects that still insist on maintaining a changelog file in git end up constantly fighting git's conflict resolution, and they make rebase almost completely unusable. For an actual log of individual changes, that's what "git log" is for; any project that pre-dates git should "git mv ChangeLog ChangeLog.pre-git". And if your "git log" output isn't highly readable, write better commit messages and group changes into more logical commits; once you stop breaking "git rebase -i", that gets a lot easier…

This project "visual changelog" usually blow my mind at every release. https://www.qgis.org/en/site/forusers/visualchangelog216/ind... And this is exactly the opposite of a git commit only changelog. They put great effort in it so that everybody wait for it eagerly, and it might one of the reasons they got lots of sponsors and users donations.

Twisell·137-point thread·

The first top-level comment from each of the four biggest threads, in HN’s own order. Excerpts are shortened; open a comment for full context.

Breakout years
3

100+ points or 50+ comments

Total points
615

reference only — not used in Hall rules or ranking

Total comments
159

reference only — not used in Hall rules or ranking

Every submission

DateTitle as submittedByPointsComments
2014-06-02Let's try to have a standard changelog formatxdmnl20
2014-08-20Keep a Changelognapolux20
2015-02-15Keep a ChangelogFirst breakoutsnake_case19743
2016-08-26Keep a Changelogvdfs13745
2018-07-28Keep a ChangelogBest thread · Latest 20+ point returnprivong27571
2021-04-28Keep a Changelogsoheilpro20