fritz-astronomer commented on code in PR #59651:
URL: https://github.com/apache/airflow/pull/59651#discussion_r2636069138
##########
providers/standard/docs/sensors/datetime.rst:
##########
@@ -23,30 +23,43 @@ TimeDeltaSensor
===============
Use the
:class:`~airflow.providers.standard.sensors.time_delta.TimeDeltaSensor` to end
sensing after specific time.
+This sensor supports **deferrable mode**, which is recommended for production
workloads to efficiently handle long-running waits.
+Basic Usage
+-----------
.. exampleinclude::
/../src/airflow/providers/standard/example_dags/example_sensors.py
:language: python
:dedent: 4
:start-after: [START example_time_delta_sensor]
:end-before: [END example_time_delta_sensor]
+Deferrable Mode (Recommended)
+------------------------------
-.. _howto/operator:TimeDeltaSensorAsync:
+For better resource utilization, especially when waiting for extended periods,
use **deferrable mode** by setting ``deferrable=True``.
+This allows the sensor to free up a worker slot while waiting, with the
Triggerer handling the time-based check asynchronously.
-TimeDeltaSensorAsync
-====================
+**Benefits of deferrable mode:**
-Use the
:class:`~airflow.providers.standard.sensors.time_delta.TimeDeltaSensorAsync` to
end sensing after specific time.
-It is an async version of the operator and requires Triggerer to run.
+* Frees worker slots during waiting periods
+* More efficient resource utilization for long waits
+* Ideal for production environments with limited worker capacity
Review Comment:
I'd instead point to
https://airflow.apache.org/docs/apache-airflow/stable/authoring-and-scheduling/deferring.html
rather than reiterating benefits
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
