|
1 | | -Commit message format (version 0.1.0) |
| 1 | +Standards (version 0.1.0) |
2 | 2 | =================== |
3 | 3 |
|
4 | 4 |
|
5 | | - WHAT IS IT? |
6 | | ------------ |
| 5 | +##Commit Message rules |
7 | 6 |
|
| 7 | +####Subject desription (first line) |
| 8 | +>1. Prefix the line with an applicable emoji (tag) |
| 9 | +>2. Limit the subject line to 50 characters |
| 10 | +>3. Separate subject from body with a blank line |
| 11 | +>4. Capitalize the subject line |
| 12 | +>5. Do not end the subject line with a period |
| 13 | +>6. Use the imperative mood in the subject line |
8 | 14 |
|
9 | | -HOW TO USE |
10 | | -------------- |
| 15 | +####Message body |
| 16 | +>7. Wrap the body at 72 characters |
| 17 | +>8. Use the body to explain the problems, limitations, and why is it necessary?. Then to explain how was addressed the issue and the effects. |
11 | 18 |
|
| 19 | +A complete description, rules and tips can be seen in [here][1]. |
12 | 20 |
|
13 | | -------------- |
| 21 | +####Tags and meaning |
14 | 22 |
|
| 23 | +>* [style] when formatting or comments on code; no code change |
| 24 | +>* [docs] when writing documentation |
| 25 | +>* [code] when improving the format/structure of the code |
| 26 | +>* [bug] when fixing a bug |
| 27 | +>* [new] when adding new feature |
| 28 | +>* [api] when functions, methods or classes have been added or removed; method signatures or return types have changed |
| 29 | +>* [typo] when typos in words or minimal changes in comment sentences |
| 30 | +>* [misc] anything not covered by the above categories, e.g. rename or move files, add configuration files, add dataset |
| 31 | +>* [test] when adding tests, refactoring tests; no production code change |
| 32 | +>* [boost] when improving performance |
| 33 | +>* [pkg] when libraries, frameworks, packages or modules are added |
15 | 34 |
|
16 | | -REFERENCE |
17 | | -------------- |
| 35 | +####Subtags |
| 36 | +>* *linux* when fixing something on Linux |
| 37 | +>* *macos* when fixing something on Mac OS |
| 38 | +>* *win* when fixing something on Windows |
| 39 | +>* *and* when fixing something on Android |
| 40 | +>* *ios* when fixing something on iOS |
| 41 | +>* *winp* when fixing something on Windows Phone |
| 42 | +
|
| 43 | +**NOTE:** The subtags *linux*, *macos*,*and*, *win*, *ios* and *winp* must be used just in combination with other tags to specify a particular change related to an O.S. |
| 44 | +>Example: |
| 45 | +> [api|macos] Subject description |
| 46 | + |
| 47 | + |
| 48 | + |
| 49 | +##REFERENCES |
18 | 50 |
|
| 51 | +1. [How to Write a Git Commit Message](http://chris.beams.io/posts/git-commit/#why-not-how) Chris Beams |
| 52 | +2. [TYPO3 CMS](http://wiki.typo3.org/CommitMessage_Format_(Git) |
| 53 | +3. [Atom](https://atom.io/docs/v0.186.0/contributing) |
| 54 | +4. [Karma](http://karma-runner.github.io/0.8/dev/git-commit-msg.html) |
19 | 55 |
|
| 56 | +[1]: http://chris.beams.io/posts/git-commit/#why-not-how |
20 | 57 | ------------- |
21 | | -This document was last modified on : March. 17th, 2015. |
| 58 | +This document was last modified on : March. 30th, 2015. |
22 | 59 |
|
23 | 60 |
|
0 commit comments