Re: What should go in our NEWS file?

[Ricardo Wurmus]

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