Bug#1111009: release-notes: Make users aware of change of configuration file syntax for package pdns-recursor

On Thu, Aug 14, 2025 at 07:31:31PM +0200, Roel Schroeven wrote:
> Because it's a breaking change, and very useful to know about before
> starting the upgrade process, at which point people haven't had a chance to
> read NEWS.Debian. The issue is very similar to e.g. the Dovecot
> configuration change that did get a mention in the Release Notes.
> 
> To avoid confusion in the future, are there guidelines that I can look up to
> find out what is supposed and not supposed to appear in the Release Notes?

Unsure. But IMO pdns-recursor is a niche package. Compare popcon 
between the two:

https://qa.debian.org/popcon.php?package=pdns-recursor

https://qa.debian.org/popcon.php?package=dovecot

The upgrade for pdns-recursor for trivial setups is trivial, for 
complex setups users need to plan ahead anyway. dovecot is in a 
different situation.

A more general question might be: if all changes are expected to be 
in the release notes, why have NEWS.Debian files at all? And who 
will write and read all these release notes entries.

Chris