Git log is not a changelog

• git-cliff

  33 7,776 9.7 Rust

  A highly customizable Changelog Generator that follows Conventional Commit specifications ⛰️

Yep, something like Git Cliff[1] is great for generating release notes from your commit messages.

And conventional commits are good thing to do regardless of whether you use them for release notes or not. Commit messages should be helpful and immediately obvious, too often its "fixed bug" or "finally figured out foo!", which really tell you nothing - might as well not have a message.

[1] https://github.com/orhun/git-cliff

• keep-a-changelog

  10 5,940 7.8 Haml

  If you build software, keep a changelog.

I agree, I used to have a NEWS file in my projects (later a NEWS.md), but as others commented, the signification of the term "changelog" has changed. Sites like https://keepachangelog.com/ really refers to release notes or news.

• InfluxDB

  www.influxdata.com featured

  Power Real-Time Data Analytics at Scale. Get real-time insights from all types of time series data with InfluxDB. Ingest, query, and analyze billions of data points in real-time with unbounded cardinality.

  

• chronicle

  2 43 8.5 Go

  a fast changelog generator sourced from PRs and Issues (by anchore)

  

we use https://github.com/anchore/chronicle to generate release notes in a changelog format using the issues and PRs from GitHub as the source of truth. In this way time well spent in the curation of issues and PRs (which is something we need to do anyway) means that we automatically get release notes for free. (disclaimer: I'm the author of chronicle)

Suggest a related project