You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
|`config`| NPM package name of a custom [conventional-changelog](https://github.com/conventional-changelog/conventional-changelog) preset. | - |
37
-
|`releaseRules`| An external module, a path to a module or an `Array` of rules. See [Release rules](#release-rules). | See [Release rules](#release-rules)|
38
-
|`parserOpts`| Additional [conventional-commits-parser](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-commits-parser#conventionalcommitsparseroptions) options that will extends ones loaded by `preset` or `config`. See [Parser options](#parser-options). | - |
|`config`| NPM package name of a custom [conventional-changelog](https://github.com/conventional-changelog/conventional-changelog) preset. | - |
37
+
|`releaseRules`| An external module, a path to a module or an `Array` of rules. See [Release rules](#release-rules). | See [Release rules](#release-rules)|
38
+
|`parserOpts`| Additional [conventional-commits-parser](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-commits-parser#conventionalcommitsparseroptions) options that will extends ones loaded by `preset` or `config`. See [Parser options](#parser-options). | - |
39
39
40
40
**NOTE:**`config` will be overwritten by the values of `preset`. You should use either `preset` or `config`, but not both. Individual properties of `parserOpts` will overwrite ones loaded with `preset` or `config`.
41
41
@@ -66,36 +66,36 @@ Each commit will be compared with each rule and when it matches, the commit will
66
66
See [release types](lib/default-release-types.js) for the release types hierarchy.
67
67
68
68
With the previous example:
69
-
* Commits with `type` 'docs' and `scope` 'README' will be associated with a `patch` release.
70
-
* Commits with `type` 'refactor' and `scope` starting with 'core-' (i.e. 'core-ui', 'core-rules', ...) will be associated with a `minor` release.
71
-
* Other commits with `type` 'refactor' (without `scope` or with a `scope` not matching the regexp `/core-.*/`) will be associated with a `patch` release.
69
+
- Commits with `type` 'docs' and `scope` 'README' will be associated with a `patch` release.
70
+
- Commits with `type` 'refactor' and `scope` starting with 'core-' (i.e. 'core-ui', 'core-rules', ...) will be associated with a `minor` release.
71
+
- Other commits with `type` 'refactor' (without `scope` or with a `scope` not matching the regexp `/core-.*/`) will be associated with a `patch` release.
72
72
73
73
#### Default rules matching
74
74
75
75
If a commit doesn't match any rule in `releaseRules` it will be evaluated against the [default release rules](lib/default-release-rules.js).
76
76
77
77
With the previous example:
78
-
* Commits with a breaking change will be associated with a `minor` release.
79
-
* Commits with `type` 'feat' will be associated with a `minor` release.
80
-
* Commits with `type` 'fix' will be associated with a `patch` release.
81
-
* Commits with `type` 'perf' will be associated with a `patch` release.
78
+
- Commits with a breaking change will be associated with a `minor` release.
79
+
- Commits with `type` 'feat' will be associated with a `minor` release.
80
+
- Commits with `type` 'fix' will be associated with a `patch` release.
81
+
- Commits with `type` 'perf' will be associated with a `patch` release.
82
82
83
83
#### No rules matching
84
84
85
85
If a commit doesn't match any rules in `releaseRules` or in [default release rules](lib/default-release-rules.js) then no release type will be associated with the commit.
86
86
87
87
With the previous example:
88
-
* Commits with `type` 'style' will not be associated with a release type.
89
-
* Commits with `type` 'test' will not be associated with a release type.
90
-
* Commits with `type` 'chore' will not be associated with a release type.
88
+
- Commits with `type` 'style' will not be associated with a release type.
89
+
- Commits with `type` 'test' will not be associated with a release type.
90
+
- Commits with `type` 'chore' will not be associated with a release type.
91
91
92
92
#### Multiple commits
93
93
94
94
If there is multiple commits that match one or more rules, the one with the highest release type will determine the global release type.
95
95
96
96
Considering the following commits:
97
-
*`docs(README): Add more details to the API docs`
98
-
*`feat(API): Add a new method to the public API`
97
+
-`docs(README): Add more details to the API docs`
98
+
-`feat(API): Add a new method to the public API`
99
99
100
100
With the previous example the release type determine by the plugin will be `minor`.
101
101
@@ -118,13 +118,13 @@ For example with `eslint` preset:
118
118
}
119
119
```
120
120
With this configuration:
121
-
* Commits with `tag` 'Docs', that contains 'README' in their header message will be associated with a `patch` release.
122
-
* Commits with `tag` 'New' will be associated with a `patch` release.
123
-
* Commits with `tag` 'Breaking' will be associated with a `major` release (per [default release rules](lib/default-release-rules.js)).
124
-
* Commits with `tag` 'Fix' will be associated with a `patch` release (per [default release rules](lib/default-release-rules.js)).
125
-
* Commits with `tag` 'Update' will be associated with a `minor` release (per [default release rules](lib/default-release-rules.js)).
126
-
* Commits with `tag` 'New' will be associated with a `minor` release (per [default release rules](lib/default-release-rules.js)).
127
-
* All other commits will not be associated with a release type.
121
+
- Commits with `tag` 'Docs', that contains 'README' in their header message will be associated with a `patch` release.
122
+
- Commits with `tag` 'New' will be associated with a `patch` release.
123
+
- Commits with `tag` 'Breaking' will be associated with a `major` release (per [default release rules](lib/default-release-rules.js)).
124
+
- Commits with `tag` 'Fix' will be associated with a `patch` release (per [default release rules](lib/default-release-rules.js)).
125
+
- Commits with `tag` 'Update' will be associated with a `minor` release (per [default release rules](lib/default-release-rules.js)).
126
+
- Commits with `tag` 'New' will be associated with a `minor` release (per [default release rules](lib/default-release-rules.js)).
127
+
- All other commits will not be associated with a release type.
0 commit comments