Date: Wed, 12 Aug 2009 12:05:12 +0000 From: Alexey Dokuchaev <danfe@FreeBSD.org> To: Doug Barton <dougb@FreeBSD.org> Cc: cvs-ports@FreeBSD.org, cvs-all@FreeBSD.org, ports-committers@FreeBSD.org Subject: Re: cvs commit: ports UPDATING Message-ID: <20090812120512.GA38933@FreeBSD.org> In-Reply-To: <4A81AA27.8040908@FreeBSD.org> References: <200908102241.n7AMfN09004919@repoman.freebsd.org> <4A80B9BE.4020408@FreeBSD.org> <20090811043217.GA6076@FreeBSD.org> <4A81AA27.8040908@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, Aug 11, 2009 at 10:28:07AM -0700, Doug Barton wrote: > Alexey Dokuchaev wrote: > > Well, it's really hard to add anything here. :-) > > "Update line breaks, punctuation, and white space on the recent KDE4 > and libtool entries to improve readability." > > I'm picking on a trivial case here, so sorry Alexey, but from what I > can see the trend is getting worse, not better. > > There are 3 main rules for log entries: > 1. Keep in mind that people will be reading this years from now when > you are long gone. > 2. A brief summary of WHAT was done makes browsing the logs and > finding specific entries easier. However if necessary that can always > be discovered with diff, so > 3. Always err on the side of including more information about WHY a > change was made. Fair enough. Thanks for being pedantic, I like it. :-) ./danfe
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20090812120512.GA38933>