Skip to content

Specify English as the required language for commit messages #682

@geriwald

Description

@geriwald

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions