Skip to content

Commit f1b0f23

Browse files
Eric Ulises García Cano CastilloEric Ulises García Cano Castillo
authored andcommitted
# By Edgar Garcia Cano # Via Edgar Garcia Cano * 'master' of https://github.com/eegkno/commit_message_format: [style>modify] New tag and use of > instead of | [style] Update documentation [docs|modify] New subtag to rename [docs|modify] Tags to report bugs
2 parents 7fed298 + 3e40d9a commit f1b0f23

File tree

1 file changed

+39
-28
lines changed

1 file changed

+39
-28
lines changed

README.md

Lines changed: 39 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
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

6165
When 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

6973
Those 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]).
8394
4. [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

Comments
 (0)