This is an automated email from the ASF dual-hosted git repository.
Miretpl pushed a commit to branch v3-3-test
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/v3-3-test by this push:
new 28e04e02653 [v3-3-test] Remove TaskFlow recommendation in doc (#71315)
(#72074)
28e04e02653 is described below
commit 28e04e0265373764578928e6617f0728798bf2ad
Author: github-actions[bot]
<41898282+github-actions[bot]@users.noreply.github.com>
AuthorDate: Tue Aug 25 22:34:07 2026 +0200
[v3-3-test] Remove TaskFlow recommendation in doc (#71315) (#72074)
* documentation - taskflow is not better than OOP
* review 1
---------
(cherry picked from commit 89b694fd3474576320fd95d699caac429fbfecd8)
Co-authored-by: raphaelauv <[email protected]>
Co-authored-by: raphaelauv <[email protected]>
---
airflow-core/docs/core-concepts/operators.rst | 2 +-
providers/standard/docs/operators/bash.rst | 4 ++--
providers/standard/docs/operators/python.rst | 28 +++++++++++++--------------
providers/standard/docs/sensors/python.rst | 4 ++--
4 files changed, 19 insertions(+), 19 deletions(-)
diff --git a/airflow-core/docs/core-concepts/operators.rst
b/airflow-core/docs/core-concepts/operators.rst
index 6bcf4a3c714..1a7c0a0015b 100644
--- a/airflow-core/docs/core-concepts/operators.rst
+++ b/airflow-core/docs/core-concepts/operators.rst
@@ -33,7 +33,7 @@ Airflow has a very extensive set of operators available, with
some built-in to t
- Use the ``@task`` decorator to execute an arbitrary Python function. It
doesn't support rendering jinja templates passed as arguments.
.. note::
- The ``@task`` decorator is recommended over the classic
:class:`~airflow.providers.standard.operators.python.PythonOperator`
+ The ``@task`` decorator is the Taskflow equivalent of
:class:`~airflow.providers.standard.operators.python.PythonOperator`
to execute Python callables with no template rendering in its arguments.
For a list of all core operators, see: :doc:`Core Operators and Hooks
Reference </operators-and-hooks-ref>`.
diff --git a/providers/standard/docs/operators/bash.rst
b/providers/standard/docs/operators/bash.rst
index 0e6425d4d36..d1bc9d13d16 100644
--- a/providers/standard/docs/operators/bash.rst
+++ b/providers/standard/docs/operators/bash.rst
@@ -31,9 +31,9 @@ determined by:
2. If using the TaskFlow decorator, ``@task.bash``, a non-empty string value
returned from the decorated callable.
-.. tip::
+.. note::
- The ``@task.bash`` decorator is recommended over the classic
``BashOperator`` to execute Bash commands.
+ The ``@task.bash`` decorator is the Taskflow equivalent of
``BashOperator`` to execute Bash commands.
.. tab-set::
diff --git a/providers/standard/docs/operators/python.rst
b/providers/standard/docs/operators/python.rst
index 30f7151e55b..e4539565658 100644
--- a/providers/standard/docs/operators/python.rst
+++ b/providers/standard/docs/operators/python.rst
@@ -24,8 +24,8 @@ PythonOperator
Use the :class:`~airflow.providers.standard.operators.python.PythonOperator`
to execute Python callables.
-.. tip::
- The ``@task`` decorator is recommended over the classic ``PythonOperator``
to execute Python callables.
+.. note::
+ The ``@task`` decorator is the Taskflow equivalent of ``PythonOperator``
to execute Python callables.
.. tab-set::
@@ -159,8 +159,8 @@ Additionally, the ``cloudpickle`` package needs to be
installed as an optional d
Cloudpickle offers a strong advantage for its focus on standard pickling
protocol, ensuring wider compatibility and
smoother data exchange, while still effectively handling common Python objects
and global variables within functions.
-.. tip::
- The ``@task.virtualenv`` decorator is recommended over the classic
``PythonVirtualenvOperator``
+.. note::
+ The ``@task.virtualenv`` decorator is the Taskflow equivalent of
``PythonVirtualenvOperator``
to execute Python callables inside new Python virtual environments.
.. tab-set::
@@ -283,8 +283,8 @@ pre-defined environment. The virtualenv package should be
preinstalled in the en
In case ``dill`` is used, it has to be preinstalled in the environment (the
same version that is installed
in main Airflow environment).
-.. tip::
- The ``@task.external_python`` decorator is recommended over the classic
``ExternalPythonOperator``
+.. note::
+ The ``@task.external_python`` decorator is the Taskflow equivalent of
``ExternalPythonOperator``
to execute Python code in pre-defined Python environments.
.. tab-set::
@@ -340,8 +340,8 @@ BranchPythonOperator
Use the
:class:`~airflow.providers.standard.operators.python.BranchPythonOperator` to
execute Python :ref:`branching <concepts:branching>`
tasks.
-.. tip::
- The ``@task.branch`` decorator is recommended over the classic
``BranchPythonOperator``
+.. note::
+ The ``@task.branch`` decorator is the Taskflow equivalent of
``BranchPythonOperator``
to execute Python code.
.. tab-set::
@@ -377,8 +377,8 @@ BranchPythonVirtualenvOperator
Use the
:class:`~airflow.providers.standard.operators.python.BranchPythonVirtualenvOperator`
decorator to execute Python :ref:`branching <concepts:branching>`
tasks and is a hybrid of the
:class:`~airflow.providers.standard.operators.python.BranchPythonOperator` with
execution in a virtual environment.
-.. tip::
- The ``@task.branch_virtualenv`` decorator is recommended over the classic
+.. note::
+ The ``@task.branch_virtualenv`` decorator is the Taskflow equivalent of
``BranchPythonVirtualenvOperator`` to execute Python code.
.. tab-set::
@@ -415,8 +415,8 @@ Use the
:class:`~airflow.providers.standard.operators.python.BranchExternalPytho
tasks and is a hybrid of the
:class:`~airflow.providers.standard.operators.python.BranchPythonOperator` with
execution in an
external Python environment.
-.. tip::
- The ``@task.branch_external_python`` decorator is recommended over the
classic
+.. note::
+ The ``@task.branch_external_python`` decorator is the Taskflow equivalent
of
``BranchExternalPythonOperator`` to execute Python code.
.. tab-set::
@@ -460,8 +460,8 @@ based on the configured short-circuiting (more on this
later). In the example be
"condition_is_true" task will execute while the tasks downstream of the
"condition_is_false" task will be
skipped.
-.. tip::
- The ``@task.short_circuit`` decorator is recommended over the classic
``ShortCircuitOperator``
+.. note::
+ The ``@task.short_circuit`` decorator is the Taskflow equivalent of
``ShortCircuitOperator``
to short-circuit pipelines via Python callables.
.. tab-set::
diff --git a/providers/standard/docs/sensors/python.rst
b/providers/standard/docs/sensors/python.rst
index 6a9118e8db0..b0318b04f9f 100644
--- a/providers/standard/docs/sensors/python.rst
+++ b/providers/standard/docs/sensors/python.rst
@@ -25,8 +25,8 @@ PythonSensor
The :class:`~airflow.providers.standard.sensors.python.PythonSensor` executes
an arbitrary callable and waits for its return
value to be True.
-.. tip::
- The ``@task.sensor`` decorator is recommended over the classic
``PythonSensor``
+.. note::
+ The ``@task.sensor`` decorator is the Taskflow equivalent of
``PythonSensor``
to execute Python callables to check for True condition.
.. tab-set::
