Restructure the Breaking changes section

stackabletech · Nov 26, 2024 · 31344b9 · 31344b9
1 parent 0141616
commit 31344b9
Showing 1 changed file with 12 additions and 2 deletions.
diff --git 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