Changes

Jump to navigation Jump to search
m
move section on commit messages
Line 22: Line 22:     
  git clone git://git.sugarlabs.org/sugar-jhbuild/mainline.git sugar-jhbuild
 
  git clone git://git.sugarlabs.org/sugar-jhbuild/mainline.git sugar-jhbuild
  −
== Git commit message guidelines ==
  −
These are guidelines to enhance the readability of the commit messages and the release notes which are made with [http://www.kernel.org/pub/software/scm/git/docs/git-shortlog.html git-shortlog]. Please try to follow them as much as possible and make suggestions in the [http://lists.sugarlabs.org/listinfo/sugar-devel sugar devel mailing list] of you find things missing, the guidelines completely insane or just want to demonstrate your appreciation.
  −
  −
* The commit message should start with a single short (less than 50 character) line summarizing the change, followed by a blank line and then a more thorough description. Tools that turn commits into email, for example, use the first line on the Subject: line and the rest of the commit in the body. The git-shortlog command that we use to write the release notes will strip the more detailed description.
  −
  −
* If your commit does fix a certain bug make sure that the summarizing line contains the bug number prepended by a '#' at the '''end''' of the line (e.g. #14). It is implied that you mean the [http://trac.sugarlabs.org Sugar Labs trac] instance. If not please prepend an identifier like OLPC#123, RH#456, Debian#666, Ubuntu#53.
  −
  −
* Start your commit message with a capital letter.
  −
  −
* Suffix no dot at the end of the summarizing line.
  −
  −
* Fixes for typing errors and pylint fixes happen quite often. Just mark them _Typo and respectively _Pylint for easier reading.
  −
  −
----
      
== See also ==
 
== See also ==
2,751

edits

Navigation menu