[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.
- Re: Is it time to drop ChangeLogs?, (continued)
- Re: Is it time to drop ChangeLogs?, Nikolaus Rath, 2016/03/08
- Re: Is it time to drop ChangeLogs?, Óscar Fuentes, 2016/03/08
- Re: Is it time to drop ChangeLogs?, David Caldwell, 2016/03/08
- Re: Is it time to drop ChangeLogs?, Dmitry Gutov, 2016/03/08
- Re: Is it time to drop ChangeLogs?, John Wiegley, 2016/03/08
- Re: Is it time to drop ChangeLogs?, Dmitry Gutov, 2016/03/08
- Re: Is it time to drop ChangeLogs?, Giuseppe Scrivano, 2016/03/08
- Re: Is it time to drop ChangeLogs?, David Caldwell, 2016/03/08
- Re: Is it time to drop ChangeLogs?, Dmitry Gutov, 2016/03/08
- Re: Is it time to drop ChangeLogs?, Óscar Fuentes, 2016/03/08
- Re: Is it time to drop ChangeLogs?,
Eli Zaretskii <=
Re: Is it time to drop ChangeLogs?, Alan Mackenzie, 2016/03/07
Re: Is it time to drop ChangeLogs? (Was: bug#21998: Run 'make change-history' on release branch), Eli Zaretskii, 2016/03/07