1- Commit message format (version 1.3.0 )
1+ Commit message format (version 1.7 )
22===================
33
44##What is it?
@@ -18,62 +18,73 @@ This is a proposal of tags to be used in commit messages. The goal is to identif
1818> 7 . Wrap the body at 72 characters
1919> 8 . Use the body to explain the problems, limitations, and why it is necessary. Then to explain how was addressed the issue and the effects.
2020
21- A complete description, rules and tips can be seen in [ here ] [ 1 ] .
21+ A complete description, rules and tips can be seen in [ 1] .
2222
2323####Tags and meaning for source code
2424** NOTE:** The first commit does not have a label, and the message always is "** Initial commit** " as convention.
2525
26- > * [ style] when formatting or comments on code; no code change
27- > * [ docs] when writing documentation
28- > * [ code] when improving the format/structure of the code
29- > * [ bug] when fixing a bug
30- > * [ new] when adding new feature (see * Rules* section)
31- > * [ api] when functions, methods or classes have been added or removed; method signatures or return types have changed
32- > * [ typo] when typos in words or minimal changes in comment sentences
26+ > * [ api] when functions, methods or classes have been added, modified or removed; method signatures or return types have changed
27+ > * [ code] when improving the format/structure of the code, without modifying the previous functionality
28+ > * [ main] when dealing with a file that is used as view, notebook or main file
3329> * [ misc] anything not covered by the above categories, e.g. rename or move files, add configuration files, add dataset
34- > * [ test] when adding tests, refactoring tests; no production code change
35- > * [ boost] when improving performance
30+ > * [ new] when adding a new feature (see * Rules* section)
3631> * [ pkg] when libraries, frameworks, packages or modules are added
32+ > * [ style] when writing documentation, formatting or comments on code; no code change
33+ > * [ test] when adding tests, refactoring tests; no production code change
34+
35+
3736
3837####Tags and meaning for database
39- > * [ pk] primary key
40- > * [ fk] foreign key
38+
4139> * [ ak] alternate key
4240> * [ chk] check restriction
43- > * [ idx ] index
44- > * [ seq ] sequence
41+ > * [ col ] column
42+ > * [ dt ] data type
4543> * [ fk] foreign key
46- > * [ vw ] view
44+ > * [ idx ] index
4745> * [ mv] materialize view
48- > * [ dt ] data type
49- > * [ trg ] trigger
46+ > * [ pk ] primary key
47+ > * [ seq ] sequence
5048> * [ tbl] table
51- > * [ col] column
49+ > * [ trg] trigger
50+ > * [ vw] view
5251
5352####Subtags
54- Those subtags are used in order to provide the action that the commite does
53+ Those subtags are used in order to provide the action that the commit does
5554> * * add* when something new has been added
55+ > * * boost* when improving performance
56+ > * * bug* when a bug is found (see * Rules* section)
57+ > * * fix* when fixing a bug (see * Rules* section)
5658> * * modify* when changes in files have been made
5759> * * move* when files are moved between directories
5860> * * remove* when files or directories are deleted
59- > * * update* when a package's version is changed (see * Rules* section)
61+ > * * rename* when files or directories are renamed
62+ > * * update* when a package's version is changed, module is added, removed or modified (see * Rules* section)
63+
6064
6165When fixing something on:
66+ > * * and* (* Android* )
67+ > * * ios*
6268> * * linux*
6369> * * macos*
6470> * * win*
65- > * * and* (* Android* )
66- > * * ios*
67- > * * winp* (* Windows Phone* )
71+
6872
6973Those subtags must be used just in combination with other tags to specify a particular change related to an O.S.
7074> Example:
71- > [ api| macos] Subject description
75+ > [ api> macos] Subject description
7276
7377####Rules
74- The tag [ new] is only used when you are doing a merge between the master and other feature-branch It is used to describe a feature.
78+ 1 . The tag [ new] is only used when you are doing a merge between a feature-branch and develop.
79+
80+ 2 . The tag [ update] must be used just when a package is updates ([ pkg|update] ).
81+
82+ 3 . Sometimes when you are doing modifications on your source code, it is likely to find a bug, in this case two actions can occur:
83+
84+ > + [ api>modify+bug] when the code was modified, a bug was found but NOT fixed
85+ > + [ api>modify+fix] when the code was modified, a bug was found and WAS fixed
86+
7587
76- The tag [ update] must be used just when a package is updates ([ pkg|update] ).
7788
7889##REFERENCES
7990
@@ -83,4 +94,4 @@ The tag [update] must be used just when a package is updates ([pkg|update]).
83944 . [ Karma] ( http://karma-runner.github.io/0.8/dev/git-commit-msg.html )
8495
8596-------------
86- This document was last modified on : April. 6th, 2015 .
97+ This document was last modified on : April 6th, 2016 .
0 commit comments