From: Oliver Kiddle <okiddle@yahoo.co.uk>
To: Mailing-list zsh-workers <zsh-workers@zsh.org>
Subject: ChangeLogs (Re: GH:zsh-users/zsh-completions.)
Date: Thu, 02 Nov 2017 00:33:49 +0100 [thread overview]
Message-ID: <14690.1509579229@thecus.kiddle.eu> (raw)
In-Reply-To: <171018180901.ZM19235@torch.brasslantern.com>
On 18 Oct, Bart wrote:
> }
> } We preserved the ChangeLog in its existing form when migrating from CVS
> } largely so that we were changing as little as possible. But we have git
> } log. All new ChangeLog entries can be autogenerated
>
> This is so appealing in theory and yet so horrible (IMO) in practice.
> Git log format does not lend itself to this [*] and its immutability
> makes it impossible to correct errors (of which we have plenty) or to
> fix mis-attribution when e.g. one of the developers is committing on
> behalf of some other contributor who should get credit.
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. As Aaron mentoned we could push replacement
references. We might also use git notes for things like mailing list
cross-references. So provided whoever makes the release is pulling
replacement refs, the ChangeLog should go out corrected. And added to
that we'd at least have a clear if clumsy mechanism for corrections to
git logs.
I held off replying earlier because I didn't want the main thread to get
side-tracked on what isn't necessarily the most important suggestion
there.
Oliver
next prev parent reply other threads:[~2017-11-01 23:34 UTC|newest]
Thread overview: 27+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <7240.1507973844@thecus.kiddle.eu>
2017-10-14 14:44 ` GH:zsh-users/zsh-completions Julien Nicoulaud
2017-10-14 16:49 ` GH:zsh-users/zsh-completions Eric Cook
2017-10-16 14:29 ` GH:zsh-users/zsh-completions Oliver Kiddle
2017-10-16 15:11 ` GH:zsh-users/zsh-completions Peter Stephenson
2017-10-16 15:24 ` GH:zsh-users/zsh-completions Bart Schaefer
2017-10-16 15:42 ` GH:zsh-users/zsh-completions Peter Stephenson
2017-10-16 17:49 ` GH:zsh-users/zsh-completions gi1242+zsh
2017-10-17 21:09 ` GH:zsh-users/zsh-completions Joey Pabalinas
2017-10-18 16:23 ` GH:zsh-users/zsh-completions Oliver Kiddle
2017-10-19 1:09 ` GH:zsh-users/zsh-completions Bart Schaefer
2017-10-19 4:03 ` GH:zsh-users/zsh-completions Aaron Schrab
2017-10-19 5:24 ` GH:zsh-users/zsh-completions Bart Schaefer
2017-11-01 23:33 ` Oliver Kiddle [this message]
2017-11-01 23:46 ` ChangeLogs (Re: GH:zsh-users/zsh-completions.) Bart Schaefer
2017-11-02 20:09 ` Oliver Kiddle
2017-10-19 1:31 ` GH:zsh-users/zsh-completions Joey Pabalinas
2017-10-19 14:37 ` GH:zsh-users/zsh-completions Daniel Shahaf
2017-10-30 23:38 ` GH:zsh-users/zsh-completions Oliver Kiddle
2017-11-01 16:35 ` GH:zsh-users/zsh-completions Daniel Shahaf
2017-11-01 22:58 ` GH:zsh-users/zsh-completions Oliver Kiddle
2017-10-16 23:00 ` GH:zsh-users/zsh-completions Bart Schaefer
2017-10-16 20:04 ` GH:zsh-users/zsh-completions Daniel Shahaf
2017-10-17 7:53 ` GH:zsh-users/zsh-completions Oliver Kiddle
2017-10-17 8:41 ` GH:zsh-users/zsh-completions Peter Stephenson
2017-10-16 15:26 ` GH:zsh-users/zsh-completions gi1242+zsh
2017-10-17 9:35 ` GH:zsh-users/zsh-completions Oliver Kiddle
2017-10-19 18:25 ` GH:zsh-users/zsh-completions Daniel Tameling
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=14690.1509579229@thecus.kiddle.eu \
--to=okiddle@yahoo.co.uk \
--cc=zsh-workers@zsh.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.vuxu.org/mirror/zsh/
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).