Re: Structured Changelogs for ELPA packages

Richard Stallman <[email protected]> Tue, 04 Aug 2026 00:23:49 -0400
Newsgroups gmane.emacs.devel
Message-ID <[email protected]>
[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

  > - The strict approach would be to say that if we want packages to have
  >   fine-granular news, that they have to use a specific file format, say
  >   Org-mode and that the sections describing specific releases have to be
  >   annotated with tags or properties.

Org mode isn't an Emacs standard for files which contain items.
It is a feature which people can use if they like, but general facilities
should not require people use Org mode.

    2. Search for headlines matching a specific pattern. I found these
       patterns:

       - Keep a Changelog: [1.2.3] - 2026-07-30
       - Common Changelog: 1.2.3 - 2026-07-30
       - Towncrier:        1.2.3 (2026-07-30)
       - Magit style:      v1.2.3 2026-07-30

Could you explain what that list means?

I can understand the second part of each line, as an example of
formating of a version number and a date.  We could easily simply
adopt one and say package maintainers should all use it.  And I think
we could easily write a converter to that one.

But the first part of each line seems to refer to things
I have never heard of.  What does "Towncrier" mean?
What does "Common Changelog" mean?

-- 
Dr Richard Stallman (https://stallman.org)
Chief GNUisance of the GNU Project (https://gnu.org)
Founder, Free Software Foundation (https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)