Improve commit messages
See original GitHub issueSince 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:
- Created 3 years ago
- Comments:6 (6 by maintainers)
Top 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 >
Top Related Medium Post
No results found
Top Related StackOverflow Question
No results found
Troubleshoot Live Code
Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free
Top Related Reddit Thread
No results found
Top Related Hackernoon Post
No results found
Top Related Tweet
No results found
Top Related Dev.to Post
No results found
Top Related Hashnode Post
No results found

@xylix Added grouping of changelog entries by type as a subtask in #377.
Submitted a PR for the CONTRIBUTING.md changes in #415
Hm yeah being able to drop most
refactor,ciandchorecommits 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.