From 7ceda3cd2e91a62892b57c7987e99f7977493380 Mon Sep 17 00:00:00 2001
From: Pepe Cano <825430+ppcano@users.noreply.github.com>
Date: Thu, 8 May 2025 17:28:58 +0200
Subject: [PATCH] [release-12.0.1] docs(alerting): clarify transition to
 Recovering state when using recovery thresholds (#105132)

docs(alerting): clarify transition to Recovering state when using recovery thresholds (#104381)

(cherry picked from commit cf1b964829a20d0686d0e571002ab7a056a19dd0)
---
 .../alerting/fundamentals/alert-rules/queries-conditions.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/sources/alerting/fundamentals/alert-rules/queries-conditions.md b/docs/sources/alerting/fundamentals/alert-rules/queries-conditions.md
index 25afe0227aa..e4569c136cd 100644
--- a/docs/sources/alerting/fundamentals/alert-rules/queries-conditions.md
+++ b/docs/sources/alerting/fundamentals/alert-rules/queries-conditions.md
@@ -124,7 +124,7 @@ If the threshold is set as the alert condition, the alert fires when the thresho
 
 ### Recovery threshold
 
-To reduce the noise from flapping alerts, you can set a recovery threshold so that the alert returns to the `Normal` state only after the recovery threshold is crossed.
+To reduce the noise from flapping alerts, you can set a recovery threshold so that the alert returns to the `Normal` or `Recovering` state only after the recovery threshold is crossed.
 
 Flapping alerts occur when the query value repeatedly crosses above and below the alert threshold, causing frequent state changes. This results in a series of firing-resolved-firing notifications and a noisy alert state history.
 
@@ -136,8 +136,8 @@ For example, if you have an alert for latency with a threshold of 1000ms and the
 
 To prevent this, you can set a recovery threshold to define two thresholds instead of one:
 
-1. An alert transitions to the `Pending` or `Alerting` state when the alert threshold is crossed.
-1. An alert transitions back to `Normal` state only after the recovery threshold is crossed.
+1. An alert transitions to the `Pending` or `Alerting` state when it crosses the alert threshold.
+1. It then transitions to the `Recovering` or `Normal` state only when it crosses the recovery threshold.
 
 In the previous example, setting the recovery threshold to 900ms means the alert only resolves when the latency falls below 900ms: