From owner-freebsd-hackers@freebsd.org  Thu Apr 14 03:44:54 2016
Return-Path: <owner-freebsd-hackers@freebsd.org>
Delivered-To: freebsd-hackers@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id 4E927B0F00E
 for <freebsd-hackers@mailman.ysv.freebsd.org>;
 Thu, 14 Apr 2016 03:44:54 +0000 (UTC)
 (envelope-from darius@dons.net.au)
Received: from ipmail04.adl6.internode.on.net (ipmail04.adl6.internode.on.net
 [150.101.137.141])
 by mx1.freebsd.org (Postfix) with ESMTP id B361B1BFD;
 Thu, 14 Apr 2016 03:44:53 +0000 (UTC)
 (envelope-from darius@dons.net.au)
Received: from ppp14-2-34-252.lns21.adl2.internode.on.net (HELO
 midget.dons.net.au) ([14.2.34.252])
 by ipmail04.adl6.internode.on.net with ESMTP; 14 Apr 2016 13:14:52 +0930
Received: from [10.0.2.26] ([10.0.2.26]) (authenticated bits=0)
 by midget.dons.net.au (8.15.1/8.14.9) with ESMTPSA id u3E3ikWp041027
 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO);
 Thu, 14 Apr 2016 13:14:51 +0930 (CST)
 (envelope-from darius@dons.net.au)
Subject: Re: Improving commit logs
Mime-Version: 1.0 (Mac OS X Mail 9.3 \(3124\))
Content-Type: text/plain; charset=us-ascii
From: "O'Connor, Daniel" <darius@dons.net.au>
In-Reply-To: <20160414034320.GQ18163@FreeBSD.org>
Date: Thu, 14 Apr 2016 13:14:46 +0930
Cc: Ngie Cooper <yaneurabeya@gmail.com>,
 FreeBSD Hackers <freebsd-hackers@freebsd.org>
Content-Transfer-Encoding: quoted-printable
Message-Id: <2FD1641C-DF99-4464-BA34-A05430D663C4@dons.net.au>
References: <56FF6534-276E-4E52-871F-5567BD9D6EC7@dons.net.au>
 <CAGHfRMAwZ-A7BspzCqAEniyQOcy1fmL85V4wjzG0gDBq6gbjtw@mail.gmail.com>
 <FBAA087E-DCF3-4FB7-922D-A333AD237A23@dons.net.au>
 <20160414032801.GP18163@FreeBSD.org>
 <1DDB0BFB-545F-4293-9BFB-020DAFD7A5C4@dons.net.au>
 <20160414034320.GQ18163@FreeBSD.org>
To: Glen Barber <gjb@FreeBSD.org>
X-Mailer: Apple Mail (2.3124)
X-Spam-Score: -2.9 () ALL_TRUSTED,BAYES_00
X-Scanned-By: MIMEDefang 2.75 on 10.0.2.1
X-BeenThere: freebsd-hackers@freebsd.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: Technical Discussions relating to FreeBSD
 <freebsd-hackers.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/freebsd-hackers>, 
 <mailto:freebsd-hackers-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-hackers/>
List-Post: <mailto:freebsd-hackers@freebsd.org>
List-Help: <mailto:freebsd-hackers-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/freebsd-hackers>, 
 <mailto:freebsd-hackers-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 14 Apr 2016 03:44:54 -0000


> On 14 Apr 2016, at 13:13, Glen Barber <gjb@FreeBSD.org> wrote:
> I absolutely agree with you that a guide on this will be beneficial.
> Sorry if my reply was taken any other way.
>=20
> If I had a genie in a bottle, my three wishes would be:
>=20
> 1) Better commit messages that address the "what";
> 2) Better explanation on the "why";

Huh interesting, I definitely would pick 2 before 1 but I can see what =
you mean for a lot of commits (especially to 30 year old cruft filled =
esoterica)

> 3) More wishes.

You wish for more genies, wishing for more wishes is usually verboten.. =
;)

--
Daniel O'Connor
"The nice thing about standards is that there
are so many of them to choose from."
 -- Andrew Tanenbaum
GPG Fingerprint - 5596 B766 97C0 0E94 4347 295E E593 DC20 7B3F CE8C