Summary
The Conventional Commits specification defines the structure and format of commit messages in detail, but does not explicitly state that commit messages should be written in English.
Problem
While the specification provides clear rules for types, scopes, descriptions, and footers, the language requirement is implicit. This can lead to inconsistencies in international teams or open-source projects where contributors might write commits in their
native language.
Proposal
Add an explicit rule stating that commit messages MUST be written in English, similar to how other aspects (like BREAKING CHANGE being uppercase) are explicitly specified.
This would:
- Ensure consistency across all projects following the spec
- Improve readability for international contributors
- Align with the de facto standard in the software industry
Suggested addition
A new rule could be added:
Commit messages MUST be written in English to ensure universal readability across international teams and open-source communities.
Or alternatively, a note in the specification header clarifying this expectation.
Summary
The Conventional Commits specification defines the structure and format of commit messages in detail, but does not explicitly state that commit messages should be written in English.
Problem
While the specification provides clear rules for types, scopes, descriptions, and footers, the language requirement is implicit. This can lead to inconsistencies in international teams or open-source projects where contributors might write commits in their
native language.
Proposal
Add an explicit rule stating that commit messages MUST be written in English, similar to how other aspects (like
BREAKING CHANGEbeing uppercase) are explicitly specified.This would:
Suggested addition
A new rule could be added:
Or alternatively, a note in the specification header clarifying this expectation.