2.0 KiB

Raw Blame History

Creating a changelog automatically

Install and configure tool

We using https://github.com/git-chglog/git-chglog, so refer to this side for installation instructions.

It is possible to test the tool by git-chglog --init without overriding anything.

Usage

Example for a new release "v2.4.0":

# optional update tool by: go install github.com/git-chglog/git-chglog/cmd/git-chglog@latest
git checkout release
git pull
git fetch --tags
git checkout dev
git pull upstream  dev
git checkout -b rel/prepare_for_release_v240
git-chglog --config .chglog/config_gobot.yml --no-case --next-tag v2.4.0 v2.3.0.. > .chglog/chglog_tmp.md

Compare

If unsure about any result of running git-chglog, just use: git log --since=2024-01-07 --pretty="- %s"

Manual adjustment

Most likely some manual work is needed to bring the items in the correct position. We use the style from "keep a changelog", together with the standard template. The changelog will be generated based on the commit messages, so please follow the Convention for Pull Request Descriptions.

An example for the following commits:

type(scope): description
i2c(PCF8583): added
gpio(HD44780): fix wrong constants
raspi(PWM): refactor usage
docs(core): usage of Kernel driver
or alternative: core(docs): usage of Kernel driver
build(style): adjust rule for golangci-lint

### Build

* **style**: adjust rule for golangci-lint

### Docs

* **core**: usage of Kernel driver

### I2c

* **PCF8583**: added


### Gpio

* **HD44780**: fix wrong constants

### Raspi

* **PWM**: refactor usage

### Type

* **scope:** description

If in doubt, please refer to the current CHANGELOG.md to find the correct way.

Finalization

After all work is done in the temporary changelog file, the content can be moved to the real one and the "chglog_tmp.md" file can be removed.

2.0 KiB Raw Blame History