Re: ChangeLogs (Re: GH:zsh-users/zsh-completions.)

[Bart Schaefer <schaefer@xxxxxxxxxxxxxxxx>]

On Wed, Nov 1, 2017 at 4:33 PM, Oliver Kiddle <okiddle@xxxxxxxxxxx> wrote:
>
> We've already got the situation that git logs can't be retrospectively
> corrected. If the value of a ChangeLog lies in its mutability that
> doesn't necessarily have to be lost if we auto-generate a ChangeLog
> before a release.

It would actually be OK with me to stop maintaining a monolithic
ChangeLog.  It would be more useful to generate a "release notes" file
that has only the changes since the last such file.  That would allow
manual corrections to said file to be preserved without concern that
they'd be stepped on by the next auto-generate, and make it a lot
easier to see what differs from the previous release (right now one
has to sort of search through ChangeLog for references to the release
event).

(OTOH it means more files to search for a particular change, if you
don't have access to the git logs.)

However, *IF* we're going to continue to maintain ChangeLog, I'd
prefer that we continue maintaining it in its present form.