From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 13445 invoked by alias); 1 Nov 2017 23:46:53 -0000 Mailing-List: contact zsh-workers-help@zsh.org; run by ezmlm Precedence: bulk X-No-Archive: yes List-Id: Zsh Workers List List-Post: List-Help: List-Unsubscribe: X-Seq: 41974 Received: (qmail 28560 invoked by uid 1010); 1 Nov 2017 23:46:53 -0000 X-Qmail-Scanner-Diagnostics: from mail-qk0-f176.google.com by f.primenet.com.au (envelope-from , uid 7791) with qmail-scanner-2.11 (clamdscan: 0.99.2/21882. spamassassin: 3.4.1. Clear:RC:0(209.85.220.176):SA:0(-4.7/5.0):. Processed in 1.819511 secs); 01 Nov 2017 23:46:53 -0000 X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on f.primenet.com.au X-Spam-Level: X-Spam-Status: No, score=-4.7 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2,SPF_PASS,T_DKIM_INVALID autolearn=ham autolearn_force=no version=3.4.1 X-Envelope-From: schaefer@brasslantern.com X-Qmail-Scanner-Mime-Attachments: | X-Qmail-Scanner-Zip-Files: | DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=brasslantern-com.20150623.gappssmtp.com; s=20150623; h=mime-version:in-reply-to:references:from:date:message-id:subject:to; bh=1uNRPAHbah9/jz3g+KoMiDoZhnGKAj0xA7DfmH2dibo=; b=IdybVDmHayqXpSQo9AXwKCZ//C0BJYts5M+EQZ2aVvJTPWuLVJvjbUJlwzcSZs9RSS mstU6dJK64SlVNc3BOzuPVFBRUThVbsQgsGAvF59Hh8L1eq22XZS3b0OGRsxXwRlST4I Skl0kc6X1o4g2uLxWg9z16l5zVVsxiv+uIKh0LAT4+hRa6t5OymUdKK3vNESW3blYGtm Ij7eORzYGUsZP/vSPLtVXRVSUDKIrDsWgaqh1WREcL/ZPJUR/ds5MegjANVSCqMtBv4x 27OuPi2Cm4b8rOrUww/OM4IZR+qcBVuHnOMKmrqNAScFvnnZHG/o6rKzL36VXMGeREZp 8SOw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to; bh=1uNRPAHbah9/jz3g+KoMiDoZhnGKAj0xA7DfmH2dibo=; b=Pkjr7ymMKt4v+QuBHGLymo4IqIVoMY6YaqIBX4ju1KVQhen+hSSGqb+GhpWhtmlyj1 +sdzY3UvzS1dg/DGfAV61pjSv7+A9i9wFCLzzFVMlW3rfzhwkjbrww6RfaWAF6nceBNV bF0tttDmohlU4G3+yRg9+lN6Xg4rjUhpOjRkSFh3WmbIU5N7PgLNpjInhnzsITfI8/Vc fAhffokN8PDvbyLSGyUgJrmn6PI8t/QpDg8a8wGhVDZlb348mpweq2BMoaVM9K6jlcvp cXjBnjBmGs/GlpakboJTZKYpBKuPJduLIebqlQB5MsnhVdo+JZZ4O67zaCHAxO+ilbDd YSoA== X-Gm-Message-State: AMCzsaU/N3Yk2crWjDNzCmmTQ3XnlRjtyE0wNeuxSpvjL75iK3HbqVcA GrWYNuM710i7qczohgHSZOyiIv8nJeUAshxvD6CqgQ== X-Google-Smtp-Source: ABhQp+SKs9r4FOwmenLG62phmz9ye+5jgipWeqJImgMq54DtOwmi1eAXb+l0ccQ2mhw+LVrzWGIwHWQ8ufU1suEdBuE= X-Received: by 10.55.15.139 with SMTP id 11mr2386503qkp.141.1509580006401; Wed, 01 Nov 2017 16:46:46 -0700 (PDT) MIME-Version: 1.0 In-Reply-To: <14690.1509579229@thecus.kiddle.eu> References: <7240.1507973844@thecus.kiddle.eu> <6529.1508164192@thecus.kiddle.eu> <20171016161151.6981579c@pwslap01u.europe.root.pri> <20171016164239.533e36fb@pwslap01u.europe.root.pri> <20171016174914.GO31613@andrew.cmu.edu> <21335.1508343802@thecus.kiddle.eu> <171018180901.ZM19235@torch.brasslantern.com> <14690.1509579229@thecus.kiddle.eu> From: Bart Schaefer Date: Wed, 1 Nov 2017 16:46:45 -0700 Message-ID: Subject: Re: ChangeLogs (Re: GH:zsh-users/zsh-completions.) To: Mailing-list zsh-workers Content-Type: text/plain; charset="UTF-8" On Wed, Nov 1, 2017 at 4:33 PM, Oliver Kiddle 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.