This is an automated email from the ASF dual-hosted git repository.
potiuk pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/main by this push:
new 43873f9b628 Clarify sensor behavior in documentation (#54815)
43873f9b628 is described below
commit 43873f9b6288a23686f56435a54b5a73549dce08
Author: Antony Southworth
<[email protected]>
AuthorDate: Tue Oct 14 06:01:17 2025 +1300
Clarify sensor behavior in documentation (#54815)
---
airflow-core/docs/core-concepts/sensors.rst | 1 +
1 file changed, 1 insertion(+)
diff --git a/airflow-core/docs/core-concepts/sensors.rst
b/airflow-core/docs/core-concepts/sensors.rst
index dfe94a50ff7..ea82f5e3b3d 100644
--- a/airflow-core/docs/core-concepts/sensors.rst
+++ b/airflow-core/docs/core-concepts/sensors.rst
@@ -19,6 +19,7 @@ Sensors
========
Sensors are a special type of :doc:`Operator <operators>` that are designed to
do exactly one thing - wait for something to occur. It can be time-based, or
waiting for a file, or an external event, but all they do is wait until
something happens, and then *succeed* so their downstream tasks can run.
+Or, in the case when that thing does _not_ happen within the configured
timeout, *fails* so that you can be alerted to the failure through the usual
mechanisms.
Because they are primarily idle, Sensors have two different modes of running
so you can be a bit more efficient about using them:
