|
| 1 | +# Contributing |
| 2 | + |
| 3 | +## Git Commit Guidelines |
| 4 | + |
| 5 | +These rules are adopted from the AngularJS project. This project uses committizen. |
| 6 | + |
| 7 | +### Commit Message Format |
| 8 | +Each commit message consists of a **header**, a **body** and a **footer**. The header has a special |
| 9 | +format that includes a **type**, a **scope** and a **subject**: |
| 10 | + |
| 11 | +``` |
| 12 | +<type>(<scope>): <subject> |
| 13 | +<BLANK LINE> |
| 14 | +<body> |
| 15 | +<BLANK LINE> |
| 16 | +<footer> |
| 17 | +``` |
| 18 | + |
| 19 | +Any line of the commit message cannot be longer 100 characters! This allows the message to be easier |
| 20 | +to read on github as well as in various git tools. |
| 21 | + |
| 22 | +### Type |
| 23 | +Must be one of the following: |
| 24 | + |
| 25 | +* **feat**: A new feature |
| 26 | +* **fix**: A bug fix |
| 27 | +* **docs**: Documentation only changes |
| 28 | +* **style**: Changes that do not affect the meaning of the code (white-space, formatting, missing |
| 29 | + semi-colons, etc) |
| 30 | +* **refactor**: A code change that neither fixes a bug or adds a feature |
| 31 | +* **test**: Adding missing tests |
| 32 | +* **chore**: Changes to the build process or auxiliary tools and libraries such as documentation |
| 33 | + generation |
| 34 | + |
| 35 | +### Scope |
| 36 | +The scope could be anything specifying place of the commit change. For example `app`, |
| 37 | +`gen`, `docs`, `gen:view`, `gen:route`, `gen:service`, etc... |
| 38 | + |
| 39 | +### Subject |
| 40 | +The subject contains succinct description of the change: |
| 41 | + |
| 42 | +* use the imperative, present tense: "change" not "changed" nor "changes" |
| 43 | +* don't capitalize first letter |
| 44 | +* no dot (.) at the end |
| 45 | + |
| 46 | +###Body |
| 47 | +Just as in the **subject**, use the imperative, present tense: "change" not "changed" nor "changes" |
| 48 | +The body should include the motivation for the change and contrast this with previous behavior. |
| 49 | + |
| 50 | +###Footer |
| 51 | +The footer should contain any information about **Breaking Changes** and is also the place to |
| 52 | +reference GitHub issues that this commit **Closes**. |
| 53 | + |
| 54 | +A detailed explanation can be found in this [document][commit-message-format]. |
| 55 | + |
| 56 | +[commit-message-format]: https://docs.google.com/document/d/1QrDFcIiPjSLDn3EL15IJygNPiHORgU1_OOAqWjiDU5Y |
0 commit comments