@gisce/commitlint-rules
v1.0.6
Published
Shareable commitlint config for GISCE JS projects
Downloads
518
Readme
gisce/commitlint-rules
This package provides a custom set of rules for commit messages in all GISCE projects and libraries, ensuring consistency and readability. It extends the conventional commit message guidelines with specific customizations suitable for our workflow.
Installation
To use gisce/commitlint-rules
in your project, first install the package along with commitlint
:
npm install --save-dev @commitlint/cli @gisce/commitlint-rules
Configuration
After installation, create a commitlint.config.js
file in the root of your project with the following content:
module.exports = {
extends: ["@gisce/commitlint-rules"],
};
This configuration extends the custom rules defined in @gisce/commitlint-rules
.
Rules
The custom rules defined in this package are as follows:
body-max-line-length
: Set to always ignore the line length in the commit message body.footer-max-line-length
: Set to always ignore the line length in the commit message footer.
These rules are built on top of the conventional commit rules provided by @commitlint/config-conventional
.
Usage
Commit messages in projects using this package will be checked against the defined rules. Ensure your commit messages are structured according to these rules to maintain consistency across GISCE's codebases.
| Commit message | Release type |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------- |
| fix(pencil): stop graphite breaking when too much pressure applied
| ~~Patch~~ Fix Release |
| feat(pencil): add 'graphiteWidth' option
| ~~Minor~~ Feature Release |
| perf(pencil): remove graphiteWidth option
BREAKING CHANGE: The graphiteWidth option has been removed.
The default graphite width of 10mm is always used for performance reasons.
| ~~Major~~ Breaking Release (Note that the BREAKING CHANGE:
token must be in the footer of the commit) |
Cheat Sheet: Commit Message Types
| Type | Category | Description |
|-----------|--------------------------|----------------------------------------------------------|
| feat
| Features | A new feature. |
| fix
| Bug Fixes | A bug fix. |
| docs
| Documentation | Documentation only changes. |
| style
| Styles | Changes that do not affect the meaning of the code. |
| refactor
| Code Refactoring | A code change that neither fixes a bug nor adds a feature.|
| perf
| Performance Improvements | A code change that improves performance. |
| test
| Tests | Adding missing tests or correcting existing tests. |
| build
| Builds | Changes that affect the build system or external dependencies. |
| ci
| Continuous Integrations | Changes to CI configuration files and scripts. |
| chore
| Chores | Other changes that don't modify src or test files. |
| revert
| Reverts | Reverts a previous commit. |
Contributing
Contributions to the gisce/commitlint-rules
package are welcome. If you have suggestions for improving or extending the rules, please open an issue or a pull request in the repository.
License
MIT