Git commit message templates

Warner Losh imp at bsdimp.com
Mon Dec 21 17:33:59 UTC 2020


On Mon, Dec 21, 2020 at 10:28 AM John Baldwin <jhb at freebsd.org> wrote:

> On 12/17/20 12:58 PM, Ed Maste wrote:
> > On Wed, 16 Dec 2020 at 17:35, John Baldwin <jhb at freebsd.org> wrote:
> >>
> >> The only one I'm not a fan of is the lack of punctuation for the first
> >> sentence.  Newspaper headlines also use additional capitalization
> >> (e.g. last word and "significant words"), so the current recommendation
> >> is a mix of things and not fully consistent with either one.
> >
> > Fair point - considering the first line as one would an email subject
> > is probably the best approach.
>
> I agree.  Perhaps just say that (rather than newspaper headline) and leave
> off the note about punctuation.
>

Personally, I think we're starting to get a bit over prescriptive here.
Once you have the length down, and have a keyword at the start, you've got
99% of the benefit. Nobody cares if there's a dot at the end or not, and
it's presence or absence adds no value to other readers. Nobody cares about
having lots of caps or not. We should just let people use their judgement.

Warner


More information about the freebsd-git mailing list