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
Thanks for contributing! Please read this document to follow our conventions for contributing to the mParticle SDK.
4
+
5
+
## Setting Up
6
+
7
+
- Fork the repository and then clone down your fork
8
+
- Commit your code per the conventions below, and PR into the mParticle Kit `master` branch
9
+
- Your PR title will be checked automatically against the below convention (view the commit history to see examples of a proper commit/PR title). If it fails, you must update your title.
10
+
- Our engineers will work with you to get your code change implemented once a PR is up
11
+
12
+
## PR Title and Commit Convention
13
+
14
+
PR titles should follow [conventional commit standards](https://www.conventionalcommits.org/). This helps automate the release process.
15
+
16
+
The standard format for commit messages is as follows:
17
+
18
+
```
19
+
<type>[optional scope]: <description>
20
+
[optional body]
21
+
[optional footer]
22
+
```
23
+
24
+
The following lists the different `types` allowed in the commit message:
25
+
26
+
- feat: A new feature (automatic minor release)
27
+
- fix: A bug fix (automatic patch release)
28
+
- docs: Documentation only changes
29
+
- style: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
30
+
- refactor: A code change that neither fixes a bug nor adds a feature
31
+
- perf: A code change that improves performance
32
+
- test: Adding missing or correcting existing tests
33
+
- chore: Changes that don't modify src or test files, such as automatic documentation generation, or building latest assets
34
+
- ci: Changes to CI configuration files/scripts
35
+
- revert: Revert commit
36
+
- build: Changes that affect the build system or other dependencies
37
+
38
+
In the footer, if there is a breaking change, start your footer with `BREAKING CHANGE:` followed by a description.
39
+
40
+
## Running Tests
41
+
42
+
```bash
43
+
$ npm install
44
+
$ npm run test // builds mparticle bundles and runs tests
45
+
```
46
+
47
+
There are additional scripts that may improve your development experience:
48
+
49
+
```bash
50
+
$ npm run watch // watches src/ files and continuously rebuilds bundles as changes are made
51
+
$ npm run watch:tests // watches test/ files and continuously rebuilds test bundles as changes are made
52
+
$ npm run test:debug // opens a browser so you can step through mParticle and test code
0 commit comments