From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.devel Subject: Re: Organizing the NEWS file a bit better Date: Mon, 6 Sep 2021 04:30:56 +0200 Message-ID: References: <87wnnwp3g8.fsf@gnus.org> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="8703"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Emacs developers To: Lars Ingebrigtsen Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Sep 06 04:32:20 2021 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mN4Qm-000241-40 for ged-emacs-devel@m.gmane-mx.org; Mon, 06 Sep 2021 04:32:20 +0200 Original-Received: from localhost ([::1]:56378 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mN4Ql-0005f6-1O for ged-emacs-devel@m.gmane-mx.org; Sun, 05 Sep 2021 22:32:19 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:49850) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mN4Pe-0004zB-TY for emacs-devel@gnu.org; Sun, 05 Sep 2021 22:31:10 -0400 Original-Received: from mail-pg1-f180.google.com ([209.85.215.180]:43600) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mN4Pd-0001sF-0p for emacs-devel@gnu.org; Sun, 05 Sep 2021 22:31:10 -0400 Original-Received: by mail-pg1-f180.google.com with SMTP id r2so5252059pgl.10 for ; Sun, 05 Sep 2021 19:31:08 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=wmrnAivK8eCRZirY8YiIFU0pyPe0xLB2jZN2jEBaTDw=; b=kke3mgnGtdcVwFgPsLyMipPsdpGEhDmoqyzk7j+LY4z1nUt5pWhumOqWP9mv/IQ97P j8CYQv+NpNRfPgeEoRFcMU7aFn4Zy60Y4DQsUgG6otaYQ/HcyUZvVvS9p4FlAN7gTePi UTUX4h7XNIPnq95DDY6RljZnf89JvxwdVc2wNP49U/Pn/B9iglCgbbwREbMAjrEvylYi UR4pQ5gREKXz+kBHDIFhTWGHev4vS3EMLt3xdFLlF2BiLsnh0tTJHIiKqW4ggyxtNUZL RuE1Hvprtm8K2oHsalXDVoLw8Lsxu8rSFO0wGvUScehB/xWgFhz64qZ1TVPmbDbdx900 4qkw== X-Gm-Message-State: AOAM530EylqgqmTLqH/H/aVVHIIKlhcMqKcsm1f1kBkSY6uIso2GSs4C VtXXZ9zQilNB2u0B23aeo5/y5YJCGfxS+zcHm5E= X-Google-Smtp-Source: ABdhPJyUrdyq5sThU2Vml7mBAbBthESYrhQ38a5GxO2xwnGaLWRPwfwTra9ysRVbJPCMdKRUGf1goD8/9wKDTCeysnw= X-Received: by 2002:a63:7d5d:: with SMTP id m29mr121495pgn.114.1630895467496; Sun, 05 Sep 2021 19:31:07 -0700 (PDT) In-Reply-To: <87wnnwp3g8.fsf@gnus.org> Received-SPF: pass client-ip=209.85.215.180; envelope-from=stefankangas@gmail.com; helo=mail-pg1-f180.google.com X-Spam_score_int: 5 X-Spam_score: 0.5 X-Spam_bar: / X-Spam_report: (0.5 / 5.0 requ) FREEMAIL_FORGED_FROMDOMAIN=0.25, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.25, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 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-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:274047 Archived-At: Lars Ingebrigtsen writes: > > I'm looking at re-organizing NEWS a bit, and I'm not sure how we prefer it. > > > > In general, I guess I also wonder if anyone will protest if I take it > > upon myself to move things around to more sensible places. > > Please go ahead. I have now pushed my reorganization of the NEWS file to master. Note that the changes were necessarily extensive, as a large portion of that file was in completely the wrong place, or at worst seemed to have been placed almost at random. This is not to criticize anyone, but really it just looks like the file started getting messy at some point and then it snowballed from there. None of the changes should be controversial, as it was just a matter trying to ensure we have some basic level of organization in the file. I've decided to push what I have so far, because I need a pause from this, and I don't want master to diverge too much from what I have. I tried to follow some general principles, for example: - Avoid editing beyond moving things around, unless the edits are very, very light. - Add subsections where it makes sense. Remove them where it doesn't. - Put the most notable changes as early as possible. For example, under "Changes in Emacs 28.1" I have a new subsection "Miscellaneous" that has many bits and pieces that I didn't feel deserve a place at the top. But I moved NonGNU ELPA to the very top. - Put obviously less used or less important things last. For example, I put Bindat at the end of "Lisp Changes" as it is only used by a small number of packages. - Put related things close whenever possible. Some of this is by nature subjective. I did the work, so I got to decide (yay!) but if you feel like I made a mistake or wrote some important feature off or something, please shuffle things around to be better. I tried hard to ensure nothing was lost,[1] but if you want to check this yourself you could use, e.g.: comm -3 <(git show HEAD^:etc/NEWS|sort) <(sort etc/NEWS) If anyone wants to review my changes in full, I suspect you will find the diff to be very hard to read. It might be easier to just read the new file and compare it to the old one. Reviews are welcome, preferably in the form of just pushing any further changes to master. Footnotes: [1] I have advocated in the past for marking documentation changes using org-mode style tags. This would mean that you add a tag like ":DOC:" on the same line as a headline, instead of "+++" on the line before. That way, one could edit the file using 'outline-move-subtree-{up,down}'. That would have made this reorganization quite a bit easier.