Skip to content

Conversation

mkleczek
Copy link
Contributor

Added guidelines for structuring commits in pull requests to maintain a clean history and facilitate reviews.

@mkleczek mkleczek force-pushed the add-pr-structure-to-contributing branch from 0488243 to 7e83e47 Compare October 22, 2025 17:22
Added guidelines for structuring commits in pull requests to maintain a clean history and facilitate reviews.
@mkleczek mkleczek force-pushed the add-pr-structure-to-contributing branch from 7e83e47 to 9c25a41 Compare October 22, 2025 18:00
* All commits in the source branch must be self contained, meaning: it should be possible to treat each commit as a separate PR.
* Commits in the source branch must contain only related changes (related means the changes target a single problem/goal). For example, any refactorings should be isolated from the actual change implementation into separate commits.
* Tests, documentation, and changelog updates should be contained in the same commits as the actual code changes they relate to. An exception to this rule is when test or documentation changes are made in separate PR.
* Commit messages must be prefixed with one of the following prefixes: `fix: `, `test: `, `docs: `, `perf: `, `refactor: `.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe link to this list instead:

'add', // Add a new feature
'amend', // To amend an unrealease commit
'change', // Breaking changes
'chore', // Update sponsors, changelog, readme etc
'ci', // CI configuration files and scripts
'docs', // Documentation
'fix', // Bug fix
'nix', // Related to Nix
'perf', // Performance improvements
'refactor', // Refactoring code
'remove', // Remove a feature or fix
'test', // Adding tests

the above is validated with commitlint

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants