Re: Structured Changelogs for ELPA packages

Richard Stallman <[email protected]> writes:

> Does any of those names refer to the GNU change log style?

I think this thread is about what the GNU Coding Standards call[1]

  "The NEWS File"

and not about "Change Logs"[2].

The style guides mentioned in this thread talk about Changelog's,
e.g.[3]:

  A changelog is a file which contains a curated, chronologically
  ordered list of notable changes for each version of a project.

But for this discussion, the above should read:

  A News file is a file which contains a curated, chronologically
  ordered list of notable changes for each version of a project.

And this in line with [1] which contains:

  In addition to its manual, the package should have a file named NEWS
  which contains a list of user-visible changes worth mentioning

The style guides mentioned up-thread try to fill a gap in [1], this is
at least my understanding.

HTH.  Best, Arash

Footnotes:
[1]  https://www.gnu.org/prep/standards/html_node/NEWS-File.html
[2]  https://www.gnu.org/prep/standards/html_node/Change-Logs.html
[3]  https://keepachangelog.com/en/1.1.0/#what