[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Is it time to drop ChangeLogs?

From: Eli Zaretskii
Subject: Re: Is it time to drop ChangeLogs?
Date: Mon, 07 Mar 2016 22:58:06 +0200

> From: Óscar Fuentes <address@hidden>
> Date: Mon, 07 Mar 2016 19:07:14 +0100
> > I agree completely. Writing a log entry in ChangeLog format is an
> > excellent opportunity for reflecting on the changeset, for summarizing
> > its intent and final shape, and for making sure nothing was left out.
> > Writing those entries teaches one discipline, the ability to describe
> > your changes in just enough detail, and facilitates communications
> > between members of the development team. And in loose teams such as
> > ours, good communications are everything.
> The same applies to writing a good commit log. I have the impression
> that the ChangeLog was acting as an excuse for poor commit logs, while
> the ChangeLog's contents could be categorized as `lame' on the best of
> cases. There is nothing on the ChangeLog that I can't get from the VC
> history, on steroids.

We can have a practice of copying the same log entries to both
places.  In fact, most people already do.

> Emacs has, probably, the worst record on commit log quality of all the
> major projects I contributed to.

That's far from truth, IME.

> Writing ChangeLogs feels so pointless (and, hence, irritant) to me that
> on the past I refrained from submitting things to Emacs and keep them on
> my local branch.

If you want to write commit log messages, you won't need any
additional effort for ChangeLogs.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]