Guidance on commit-comment formats.
This commit is contained in:
parent
12983c7798
commit
ea1c65d4bb
2 changed files with 20 additions and 1 deletions
|
@ -1,7 +1,8 @@
|
|||
2014-10-27 Eric S. Raymond <esr@thyrsus.com>
|
||||
|
||||
* notes/bzr: Renamed to notes/repo, reorganixed to separate
|
||||
VCS-dependent from VCS-independent stuff.
|
||||
VCS-dependent from VCS-independent stuff. Added guidance about
|
||||
commit-comment format under DVCSes.
|
||||
|
||||
* notes/BRANCH: Merged into notes/repo.
|
||||
|
||||
|
|
|
@ -1,5 +1,23 @@
|
|||
NOTES ON COMMITTING TO EMACS'S REPOSITORY -*- outline -*-
|
||||
|
||||
* Use DVCS commenting conventions
|
||||
|
||||
Commits should follow the conventions used in all modern distributed
|
||||
version-control systems. That is, they should consist of
|
||||
|
||||
- A self-contained topic line no more than 75 chars long.
|
||||
|
||||
- If other content follows the topic line, there should be
|
||||
a blank line separating the two.
|
||||
|
||||
Try to keep your commits - and your commit comments - small. If
|
||||
you feel an urge to put a bullet list in your commit comment, it's
|
||||
doing too many things at once.
|
||||
|
||||
Yes, these directins are a departure from historical Emacs practice,
|
||||
but it helps modern log-viewing and summary tools work better so that
|
||||
other people can comprehend your code.
|
||||
|
||||
* Commit to the right branch
|
||||
|
||||
You can view the available Emacs branches at
|
||||
|
|
Loading…
Add table
Reference in a new issue