Briefle words · Code & architecture
Conventional Commits
A widely used format for commit messages, 'type(scope): summary', where the type is a word like feat, fix or docs.
Say it to an AI
Commit these changes as atomic commits, one logical change each, with Conventional Commits messages: 'type(scope): summary' in the imperative, under 60 characters, saying what changed and where (e.g. 'fix(invoices): round VAT per line'). No 'wip', 'fix' or 'update' on their own.
How an expert would brief the stronger version of “Commit history”.
See it
Try it as a puzzle →The last week of commits on main for an invoicing app, as seen on its repository page.
Why: Every line in B follows it, so you can see at a glance that there are three fixes, one feature and one dependency bump.
Related words
Room 1 · Essentials
Learn “Conventional Commits” in a five-minute lesson