Skip to content

Commit afb97f4

Browse files
committed
update contributing - change commit message format
1 parent 4f7ddd2 commit afb97f4

File tree

1 file changed

+33
-1
lines changed

1 file changed

+33
-1
lines changed

CONTRIBUTING.md

Lines changed: 33 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,4 +18,36 @@ Revisions of this nature will result in a 0.0.X change of the version number.
1818

1919
If major functionality is being added, or there will need to be gestation time for a change, it should be submitted against the __feature__ branch.
2020

21-
Revisions of this nature will result in a 0.X.X change of the version number.
21+
Revisions of this nature will result in a 0.X.X change of the version number.
22+
23+
24+
## Commit message format
25+
26+
To support our automated release process, pull requests are required to follow the [Conventional Commit](https://www.conventionalcommits.org/en/v1.0.0/)
27+
format.
28+
29+
Each commit message consists of a **header**, an optional **body** and an optional **footer**. The header is the first line of the commit and
30+
MUST have a **type** (see below for a list of types) and a **description**. An optional **scope** can be added to the header to give extra context.
31+
32+
```
33+
<type>[optional scope]: <short description>
34+
<BLANK LINE>
35+
<optional body>
36+
<BLANK LINE>
37+
<optional footer(s)>
38+
```
39+
40+
The recommended commit types used are:
41+
42+
- **feat** for feature updates (increments the _minor_ version)
43+
- **fix** for bug fixes (increments the _patch_ version)
44+
- **perf** for performance related changes e.g. optimizing an algorithm
45+
- **refactor** for code refactoring changes
46+
- **test** for test suite updates e.g. adding a test or fixing a test
47+
- **style** for changes that don't affect the meaning of code. e.g. formatting changes
48+
- **docs** for documentation updates e.g. ReadMe update or code documentation updates
49+
- **build** for build system changes (gradle updates, external dependency updates)
50+
- **ci** for CI configuration file changes e.g. updating a pipeline
51+
- **chore** for miscallaneous non-sdk changesin the repo e.g. removing an unused file
52+
53+
Adding a footer with the prefix **BREAKING CHANGE:** will cause an increment of the _major_ version.

0 commit comments

Comments
 (0)