From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Robert Weiner Newsgroups: gmane.emacs.devel Subject: Re: Is it time to drop ChangeLogs? Date: Wed, 6 Jul 2016 11:08:39 -0400 Message-ID: References: <56BE7E37.3090708@cs.ucla.edu> <4hd1rw1ubr.fsf@fencepost.gnu.org> <83vb50wxhv.fsf@gnu.org> <87y49vz4cg.fsf@acer.localhost.com> <87twg2g86g.fsf@lifelogs.com> Reply-To: rswgnu@gmail.com NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 X-Trace: ger.gmane.org 1467818044 21436 80.91.229.3 (6 Jul 2016 15:14:04 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 6 Jul 2016 15:14:04 +0000 (UTC) To: emacs-devel Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Jul 06 17:13:59 2016 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1bKoWV-0001bD-7D for ged-emacs-devel@m.gmane.org; Wed, 06 Jul 2016 17:13:59 +0200 Original-Received: from localhost ([::1]:34115 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bKoWU-0002ZF-H8 for ged-emacs-devel@m.gmane.org; Wed, 06 Jul 2016 11:13:58 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:55305) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bKoRy-0006BS-OF for emacs-devel@gnu.org; Wed, 06 Jul 2016 11:09:19 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bKoRs-00068c-2E for emacs-devel@gnu.org; Wed, 06 Jul 2016 11:09:17 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:35491) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bKoRr-00068C-V1 for emacs-devel@gnu.org; Wed, 06 Jul 2016 11:09:11 -0400 Original-Received: from mail-oi0-f48.google.com ([209.85.218.48]:36021) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1bKoRp-0007i9-QX for emacs-devel@gnu.org; Wed, 06 Jul 2016 11:09:10 -0400 Original-Received: by mail-oi0-f48.google.com with SMTP id f189so274579854oig.3 for ; Wed, 06 Jul 2016 08:09:09 -0700 (PDT) X-Gm-Message-State: ALyK8tLE8bDTPrNnQy2geXJ9QuC5Bcg1bOgjZ3kENePQttSnmSl+wDKtDWJM0+Xkbly7ESX6oUgvclvLXQDMsg== X-Received: by 10.202.192.214 with SMTP id q205mr13072892oif.176.1467817748846; Wed, 06 Jul 2016 08:09:08 -0700 (PDT) Original-Received: by 10.202.212.143 with HTTP; Wed, 6 Jul 2016 08:08:39 -0700 (PDT) In-Reply-To: <87twg2g86g.fsf@lifelogs.com> X-Gmail-Original-Message-ID: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:205259 Archived-At: On Wed, Jul 6, 2016 at 10:20 AM, Ted Zlatanov wrote: > A big advantage of pull requests is that they can group commits, so each > commit doesn't need the level of detail it does today, and so the > evolution of the work is visible to a reviewer. > > Then ChangeLogs become simply documentation for the merged code, > together with actual docs and other notes that are needed. The pull > request system can later provide *everything* that a ChangeLog could, > and more (such as better searching and cross-referencing) so in the long > term the ChangeLog can go away. ChangeLogs can group commits of code changes quite simply (just group the change comments together) and have the advantage that no special tools are needed to review them, just browse them linearly or search for changes within a specific release. I would be in favor of grouping changes spanning multiple days together and using the final date rather than having them split into separate entries by day. I agree that having to provide secondary commentary in a commit log is a pain and duplicative of effort but I don't have any suggestion for solution on that. Bob