Show More
@@ -40,13 +40,43 b' generating release notes is as painless and accurate as possible.' | |||
|
40 | 40 | committing something that is completely (or almost so) a third-party |
|
41 | 41 | contribution, do the commit as:: |
|
42 | 42 | |
|
43 | $ git commit --author="Someone Else" | |
|
43 | $ git commit --author="Someone Else <who@somewhere.com>" | |
|
44 | 44 | |
|
45 | 45 | This way it will show that name separately in the log, which makes it even |
|
46 | 46 | easier to spot. Obviously we often rework third party contributions |
|
47 |
extensively |
|
|
47 | extensively, but this is still good to keep in mind for cases when we don't | |
|
48 | 48 | touch the code too much. |
|
49 | 49 | |
|
50 | 50 | |
|
51 | 51 | .. [Git] The Git version control system. |
|
52 | 52 | .. [Github.com] Github.com. http://github.com |
|
53 | ||
|
54 | ||
|
55 | Commit messages | |
|
56 | =============== | |
|
57 | ||
|
58 | Good commit messages are very important; they provide a verbal account of what | |
|
59 | happened that is often invaluable for anyone trying to undestand the intent of | |
|
60 | a commit later on (including the original author!). And git's log command is a | |
|
61 | very versatile and powerful tool, capable of extracting a lot of information | |
|
62 | from the commit logs, so it's important that these logs actually have useful | |
|
63 | information in them. | |
|
64 | ||
|
65 | In short, a commit message should have the form:: | |
|
66 | ||
|
67 | One line summary. | |
|
68 | <THIS LINE MUST BE LEFT BLANK> | |
|
69 | More detailed description of what was done, using multiple lines and even | |
|
70 | more than one paragraph if needed. For very simple commits this may not be | |
|
71 | necessary, but non-trivial ones should always have it. | |
|
72 | ||
|
73 | Closes gh-NNN. # if the commit closes issue NNN on github. | |
|
74 | ||
|
75 | This format is understood by many git tools that expect a *single line* | |
|
76 | summary, so please do respect it. | |
|
77 | ||
|
78 | An excellent reference on commits message is `this blog post`_, please take a | |
|
79 | moment to read it (it's short but very informative). | |
|
80 | ||
|
81 | .. _this blog post: http://who-t.blogspot.com/2009/12/on-commit-messages.html | |
|
82 |
General Comments 0
You need to be logged in to leave comments.
Login now