question-mark
Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Improve commit messages

See original GitHub issue

Since we’ve started auto-generating changelogs I started looking into how other projects do it and many do so by enforcing a standard format for commit messages.

One prominent standard is Conventional Commits. A few examples:

fix: fixed bug #X
docs: updated README
ci: added platform to CI

Types I propose we use are: fix, feat, build, chore, ci, docs, style, refactor, perf, test

It’s important that we strike a good balance. We don’t want to discourage new contributors by being nitpicky. Worst case we can always clean up the changelog manually, but having at least most commit follow the convention would make things easier.

  • Update CONTRIBUTING.md with guidelines

Related to #377

Thoughts @johan-bjareholt, @xylix?

Issue Analytics

  • State:closed
  • Created 3 years ago
  • Comments:6 (6 by maintainers)

github_iconTop GitHub Comments

1reaction
ErikBjarecommented, Apr 19, 2020

@xylix Added grouping of changelog entries by type as a subtask in #377.

Submitted a PR for the CONTRIBUTING.md changes in #415

0reactions
xylixcommented, Mar 25, 2020

Hm yeah being able to drop most refactor, ci and chore commits from the changelog automatically would make generating changelogs much nicer, so I agree with adding this to the guidelines and will try to follow it in the future.

Read more comments on GitHub >

github_iconTop Results From Across the Web

How to Write Better Git Commit Messages – A Step-By- ...
5 Steps to Write Better Commit Messages · Capitalization and Punctuation: Capitalize the first word and do not end in punctuation. · Mood:...
Read more >
Writing Better Commit Messages
The benefits of writing good commit messages are not only limited to your team, but indeed expand to yourself and future contributors.
Read more >
Writing Meaningful Commit Messages
What Is a Good Commit Message? · Atomic Commits · Short and Unambiguous · Active Voice · Detailed Enough · Formatting.
Read more >
Patterns for writing better git commit messages
The 7 rules of a great commit message: · Separate subject from the body with a blank line · Limit the subject line...
Read more >
Write Better Git Commit Messages To Increase Your Productivity
5 Steps To Improve Your Git Messages · Capitalization and Punctuation: The first word should be capitalized and not end in punctuation. ·...
Read more >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found