Merge pull request #31242 from rallytime/doc-onfail-change

Document onfail requisite bugfix behavior change

doc/ref/states/requisites.rst

@@ -395,6 +395,14 @@ The ``onfail`` requisite is applied in the same way as ``require`` as ``watch``:
         - onfail:
           - mount: primary_mount
 
+.. note::
+
+    Beginning in the ``Carbon`` release of Salt, ``onfail`` uses OR logic for
+    multiple listed ``onfail`` requisites. Prior to the ``Carbon`` release,
+    ``onfail`` used AND logic. See `Issue #22370`_ for more information.
+
+.. _Issue #22370: https://github.com/saltstack/salt/issues/22370
+
 onchanges
 ~~~~~~~~~
 

doc/topics/releases/carbon.rst

@@ -24,6 +24,7 @@ Grains Changes
 Functionality Changes
 =====================
 
+- The ``onfail`` requisite now uses OR logic instead of AND logic. :issue:`22370`
 - The consul external pillar now strips leading and trailing whitespace. :issue:`31165`
 
 Deprecations