Date: Mon, 26 Jul 1999 16:32:40 -0700 (PDT) From: Archie Cobbs <archie@whistle.com> To: vanderh@ecf.utoronto.ca (Tim Vanderhoek) Cc: nate@mt.sri.com, mjacob@FreeBSD.org, cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/usr.bin/msgs msgs.1 msgs.c Message-ID: <199907262332.QAA75551@bubba.whistle.com> In-Reply-To: <19990724175234.C13618@mad> from Tim Vanderhoek at "Jul 24, 99 05:52:34 pm"
next in thread | previous in thread | raw e-mail | index | archive | help
Tim Vanderhoek writes: > In general, I think the average FreeBSD committer has a better style > for writing commit messages than committers from other projects with > closed CVS repos or that are just learning what a source repo is. > > Things a good commit message contains, > > 1) summary of the change > 2) justification/reasoning > 3) list of side effects > 4) references (PRs, people, other commits, mail, etc). I'd add: remember who the real target audience is. It's not the freebsd-committers mailing list. It's some poor sod N years from now trying to decipher what the hell happened way back in 1999. That's why comments like "fennerism" and "brucify" are pretty useless.. soon nobody is going to remember who any of us were :-) -Archie ___________________________________________________________________________ Archie Cobbs * Whistle Communications, Inc. * http://www.whistle.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199907262332.QAA75551>