[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: What should go in our NEWS file?
From: |
Ricardo Wurmus |
Subject: |
Re: What should go in our NEWS file? |
Date: |
Sun, 22 Apr 2018 16:57:37 +0200 |
User-agent: |
mu4e 1.0; emacs 25.3.1 |
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’s 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 “guix pack” or a new 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