From e1cb23beee9d339b6203544d37ce5d8854d62018 Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Mon, 3 Nov 2025 10:26:47 -0500
Subject: [PATCH] docs(remote): Add sections to important notices

Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
---
 docs/backends/remote.rst | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/docs/backends/remote.rst b/docs/backends/remote.rst
index 054cd37c3f..c7165a700c 100644
--- a/docs/backends/remote.rst
+++ b/docs/backends/remote.rst
@@ -29,16 +29,20 @@ connector.
 Important notices
 -----------------
 
-There is a breaking change on v4.0 and later. Before version 4.0, the
-DNS names passed in queries were sent without a trailing dot, after version 4.0
-the DNS names are always sent with trailing dot. F.ex. example.org is now sent
-as example.org.
+Broken networks with ipv6 suffixes
+==================================
 
 In some (broken) network setups, the IP addresses provided in the
 request (when this is an IPv6 address) may be suffixed with a ``%`` and
 the name of the network interface (e.g. ``%eth1``). Keep this in mind
 when checking the IP addresses.
 
+Breaking changes from pre v4.0 to v4.0+
+=======================================
+Before version 4.0, the DNS names passed in queries were sent without a trailing
+dot, after version 4.0 the DNS names are always sent with trailing dot. F.ex.
+example.org is now sent as example.org.
+
 Compiling
 ---------
 
-- 
2.47.3