From 10207be843ec76c1538a111187de1bb27685fb5b Mon Sep 17 00:00:00 2001
From: tdashelby-cmyk <253610080+tdashelby-cmyk@users.noreply.github.com>
Date: Mon, 11 May 2026 16:54:09 +0200
Subject: [PATCH] Document retry_dns failover behavior

---
 doc/ref/configuration/minion.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/ref/configuration/minion.rst b/doc/ref/configuration/minion.rst
index 8735f619b48c..d3f5a93da677 100644
--- a/doc/ref/configuration/minion.rst
+++ b/doc/ref/configuration/minion.rst
@@ -366,6 +366,10 @@ Set the number of seconds to wait before attempting to resolve
 the master hostname if name resolution fails. Defaults to 30 seconds.
 Set to zero if the minion should shutdown and not retry.
 
+When :conf_minion:`master_type` is set to ``failover``, Salt sets
+``retry_dns`` to ``0`` during startup so the minion can fail over to the
+next master on DNS errors.
+
 .. code-block:: yaml
 
     retry_dns: 30