From 917d6a61c0dc01fe4ab6c7f622e10a917ebdd5b8 Mon Sep 17 00:00:00 2001
From: Michal Nowak <mnowak@isc.org>
Date: Fri, 6 Jun 2025 11:11:46 +0200
Subject: [PATCH] Prepare release notes for BIND 9.20.10

---
 doc/arm/notes.rst           |  1 +
 doc/notes/notes-9.20.10.rst | 64 +++++++++++++++++++++++++++++++++++++
 2 files changed, 65 insertions(+)
 create mode 100644 doc/notes/notes-9.20.10.rst

diff --git a/doc/arm/notes.rst b/doc/arm/notes.rst
index c4a6b0ace4..9c1c19c9fa 100644
--- a/doc/arm/notes.rst
+++ b/doc/arm/notes.rst
@@ -45,6 +45,7 @@ The list of known issues affecting the latest version in the 9.20 branch can be
 found at
 https://gitlab.isc.org/isc-projects/bind9/-/wikis/Known-Issues-in-BIND-9.20
 
+.. include:: ../notes/notes-9.20.10.rst
 .. include:: ../notes/notes-9.20.9.rst
 .. include:: ../notes/notes-9.20.8.rst
 .. include:: ../notes/notes-9.20.7.rst
diff --git a/doc/notes/notes-9.20.10.rst b/doc/notes/notes-9.20.10.rst
new file mode 100644
index 0000000000..33733123bd
--- /dev/null
+++ b/doc/notes/notes-9.20.10.rst
@@ -0,0 +1,64 @@
+.. Copyright (C) Internet Systems Consortium, Inc. ("ISC")
+..
+.. SPDX-License-Identifier: MPL-2.0
+..
+.. This Source Code Form is subject to the terms of the Mozilla Public
+.. License, v. 2.0.  If a copy of the MPL was not distributed with this
+.. file, you can obtain one at https://mozilla.org/MPL/2.0/.
+..
+.. See the COPYRIGHT file distributed with this work for additional
+.. information regarding copyright ownership.
+
+Notes for BIND 9.20.10
+----------------------
+
+New Features
+~~~~~~~~~~~~
+
+- Implement a new 'notify-defer' configuration option.
+
+  This new option sets a delay (in seconds) to wait before sending a set
+  of NOTIFY messages for a zone. Whenever a NOTIFY message is ready to
+  be sent, sending will be deferred for this duration. This option is
+  not to be confused with the :any:`notify-delay` option. The default is
+  0 seconds. :gl:`#5259`
+
+Removed Features
+~~~~~~~~~~~~~~~~
+
+- Implement the systemd notification protocol manually to remove
+  dependency on libsystemd.
+
+  libsystemd, despite being useful, adds a huge surface area for just
+  using the sd_notify API. libsystemd's surface has been exploited in
+  the past [1].
+
+  Implement the systemd notification protocol by hand since it is just
+  sending newline-delimited datagrams to a UNIX socket. The code
+  shouldn't need more attention in the future since the notification
+  protocol is covered under systemd's stability promise [2].
+
+  We don't need to support VSOCK-backed service notifications since they
+  are only intended for virtual machine inits.
+
+  [1]: https://www.openwall.com/lists/oss-security/2024/03/29/4 [2]:
+  https://systemd.io/PORTABILITY_AND_STABILITY/
+
+Bug Fixes
+~~~~~~~~~
+
+- Fix zone deletion issue.
+
+  A secondary zone could initiate a new zone transfer from the primary
+  server after it had been already deleted from the secondary server,
+  and before the internal garbage collection was activated to clean it
+  up completely. This has been fixed. :gl:`#5291`
+
+- Fix a zone refresh bug.
+
+  A secondary zone could fail to further refresh with new versions of
+  the zone from a primary server if named was reconfigured during the
+  SOA request step of an ongoing zone transfer. This has been fixed.
+  :gl:`#5307`
+
+