From mboxrd@z Thu Jan 1 00:00:00 1970 From: Ricardo Wurmus Subject: Re: What should go in our NEWS file? Date: Sun, 22 Apr 2018 16:57:37 +0200 Message-ID: <87h8o3thjy.fsf@elephly.net> References: <87in8jy8es.fsf@garuda.local.i-did-not-set--mail-host-address--so-tickle-me> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:34737) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fAGR4-0007IH-6Z for guix-devel@gnu.org; Sun, 22 Apr 2018 10:57:51 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fAGR1-0007a2-5I for guix-devel@gnu.org; Sun, 22 Apr 2018 10:57:50 -0400 Received: from sender-of-o51.zoho.com ([135.84.80.216]:21030) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fAGR0-0007XX-SD for guix-devel@gnu.org; Sun, 22 Apr 2018 10:57:47 -0400 In-reply-to: <87in8jy8es.fsf@garuda.local.i-did-not-set--mail-host-address--so-tickle-me> List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Chris Marusich Cc: guix-devel@gnu.org Hi Chris, > The Guix source tree contains a NEWS file in its root directory. What > is supposed to go into this NEWS file? When should we update it? It=E2=80=99s updated prior to making a release. > I'm curious to know what sort of changes should be included in our NEWS > file, and what sort of changes should not. I'd like to know so that I > will know when I need to update the file. As you can see we use the same sections for every new release: package management distribution (also includes list of package additions and updates) programming interfaces noteworthy bug fixes native language support Some of these sections could be added to when a new notable feature has been added (e.g. a new export format for =E2=80=9Cguix pack=E2=80=9D or a n= ew build system). In the past we have been doing this when preparing for the new release, but it may make things easier on whoever cuts the new release if we edited the file as needed when notable features are merged. -- Ricardo