@dgc-org/commitlint-config-conventional-changelog-for-jira

Shareable commitlint config enforcing the Angular commit convention and Jira Smart Commit Syntax. Based on @commitlint/config-angular.

Use with @dgc-org/cz-conventional-changelog-for-jira, @commitlint/cli.

Getting started

1npm install --save-dev @dgc-org/commitlint-config-conventional-changelog-for-jira @commitlint/cli
2echo "module.exports = {extends: ['@dgc-org/commitlint-config-conventional-changelog-for-jira']};" > commitlint.config.js

Disabling commitlint

In some cases it might be useful to be able to skip linting, e.g. when lacking access to Jira or having to do nasty things in GitOps. This configuration skips the linting process altogether if either of these conditions are satisfied:

• Commit message starts with WIP:, e.g. WIP: the office is burning down, need to save my work
• Environment variable COMMITLINT_DISABLE is set to true (case-insensitive) or 1

This mechanism should only be used in situations where there's no alternative to it, rather than to ignore fixable validation failures.

Rules

Problems

The following rules are considered problems for @dgc-org/commitlint-config-conventional-changelog-for-jira and will yield a non-zero exit code when not met. Consult docs/rules for a list of available rules.

type-enum

• condition: type is found in value
• rule: always
• value

1[
2  "feat",
3  "fix",
4  "docs",
5  "refactor",
6  "test",
7  "style",
8  "build",
9  "ci",
10  "chore",
11  "revert",
12  "perf",
13  "wip",
14]

1echo "foo: some message" # fails
2echo "fix: some message" # passes

type-case

• description: type is in case value
• rule: always
• value

1'lowerCase'

1echo "FIX: some message" # fails
2echo "fix: some message" # passes

type-empty

• condition: type is empty
• rule: never

1echo ": some message" # fails
2echo "fix: some message" # passes

scope-case

• condition: scope is in case value
• rule: always

1'lowerCase'

1echo "fix(SCOPE): some message" # fails
2echo "fix(scope): some message" # passes

subject-case

• condition: subject is in one of the cases ['sentence-case', 'start-case', 'pascal-case', 'upper-case']
• rule: never

1echo "fix(SCOPE): Some message" # fails
2echo "fix(SCOPE): Some Message" # fails
3echo "fix(SCOPE): SomeMessage" # fails
4echo "fix(SCOPE): SOMEMESSAGE" # fails
5echo "fix(scope): some message" # passes
6echo "fix(scope): some Message" # passes

subject-empty

• condition: subject is empty
• rule: never

1echo "fix:" # fails
2echo "fix: some message" # passes

subject-full-stop

• condition: subject ends with value
• rule: never
• value

1'.'

1echo "fix: some message." # fails
2echo "fix: some message" # passes

header-max-length

• condition: header has value or less characters
• rule: always
• value

172

1echo "fix: some message that is way too long and breaks the line max-length by several characters" # fails
2echo "fix: some message" # passes

Warnings

The following rules are considered warnings for @dgc-org/commitlint-config-conventional-changelog-for-jira and will print warning messages when not met.

body-leading-blank

• condition: Body begins with blank line
• rule: always