[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Commit messages and git branches

From: Schanzenbach, Martin
Subject: Commit messages and git branches
Date: Sat, 3 Apr 2021 09:07:33 +0200

Dear developers,

in light of recent commits and generally over the past few releases I would 
like to urge you to
adhere to our commit message guidelines. They are quite simple:

- Use meaningful commit messages that can be used in a ChangeLog entry
- Minor changes/fix messages can be short and MUST be prefixed with "-"

We generate the ChangeLog update using a script on each release so it is 
a lot of work if we have to manually purge release messages such as "fix" or 
"cleanup" which
do not convey any useful information in a changelog.

It is also reasonable to prefix your commit messages with the subsystem the fix 
is for,
for example:

IDENTITY: Fix wrong key construction for anonymous ECDSA identity

If you accidentally forgot to add a "-" for a commit you can change the message 

$ git commit --amend

if you had multiple minor commits where you forgot you can squash them.

If you already pushed those commits to master this will not work, however,
Which brings me to the second point:

If you think you may forget this for a longer period of time during your work,
please USE A BRANCH. It is an advisable idea *in general*.
Our git is set up so that developers can setup user branches:


When you create a branch in this manner, you can force push it or delete it 
Other branches can only be force pushed or removed by admins.

Thank you for the cooperation


Attachment: signature.asc
Description: Message signed with OpenPGP

reply via email to

[Prev in Thread] Current Thread [Next in Thread]