From 31344b978fbb8038057b8f6442533778302c5a98 Mon Sep 17 00:00:00 2001
From: Nick <10092581+NickLarsenNZ@users.noreply.github.com>
Date: Tue, 26 Nov 2024 14:29:02 +0100
Subject: [PATCH] Restructure the Breaking changes section

---
 modules/ROOT/pages/release-notes.adoc | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/modules/ROOT/pages/release-notes.adoc b/modules/ROOT/pages/release-notes.adoc
index d8a09eabe..af4a8d7cf 100644
--- a/modules/ROOT/pages/release-notes.adoc
+++ b/modules/ROOT/pages/release-notes.adoc
@@ -241,10 +241,20 @@ These OpenShift versions are no longer supported:
 
 === Breaking changes
 
+Of the changes mentioned above, the following are breaking (or could lead to breaking behaviour), and you will need to adapt your existing CRDs accordingly:
+
 ==== Listener operator
 
-BREAKING: All ListenerClasses now default to using DNS hostnames, previously NodePort ListenerClasses (such as external-unstable) would use IP addresses.
-Hence, all Nodes must now have resolvable hostnames, or the NodePort ListenerClasses must be configured to set `.spec.preferredAddressType: IP`.
+All ListenerClasses now default to using Fully Qualified Domain Names (FQDNs). 
+Previously, NodePort ListenerClasses (such as external-unstable) would use the IP addresses.
+
+All Nodes must now have resolvable hostnames, or the NodePort ListenerClasses must be configured with `spec.preferredAddressType: IP`.
+
+.Breaking changes details
+[%collapsible]
+====
+* `spec.preferredAddressType`: Defaults to `HostnameConservative`, but can be set to `Hostname` or `IP`.
+====
 
 === Upgrade from 24.7