diff --git a/airflow-core/docs/core-concepts/dags.rst b/airflow-core/docs/core-concepts/dags.rst index 5d2b4925345e8..ab397f3532c26 100644 --- a/airflow-core/docs/core-concepts/dags.rst +++ b/airflow-core/docs/core-concepts/dags.rst @@ -367,7 +367,7 @@ The ``@task.branch`` can also be used with XComs allowing branching context to d If you wish to implement your own operators with branching functionality, you can inherit from :class:`~airflow.operators.branch.BaseBranchOperator`, which behaves similarly to ``@task.branch`` decorator but expects you to provide an implementation of the method ``choose_branch``. .. note:: - The ``@task.branch`` decorator is recommended over directly instantiating :class:`~airflow.providers.standard.operators.python.BranchPythonOperator` in a Dag. The latter should generally only be subclassed to implement a custom operator. + The ``@task.branch`` decorator is the Taskflow equivalent of :class:`~airflow.providers.standard.operators.python.BranchPythonOperator`. The latter should generally only be subclassed to implement a custom operator. As with the callable for ``@task.branch``, this method can return the ID of a downstream task, or a list of task IDs, which will be run, and all others will be skipped. It can also return None to skip all downstream task:: diff --git a/providers/snowflake/docs/operators/snowpark.rst b/providers/snowflake/docs/operators/snowpark.rst index cbffb01e64c9d..c9bc0689ae95d 100644 --- a/providers/snowflake/docs/operators/snowpark.rst +++ b/providers/snowflake/docs/operators/snowpark.rst @@ -28,9 +28,9 @@ Use the :class:`SnowparkOperator `__ because conflicting pandas version is used in Airflow. Consider using Snowpark pandas API with other Snowpark decorators or operators. -.. tip:: +.. note:: - The :doc:`@task.snowpark ` decorator is recommended over the ``SnowparkOperator`` to run Snowpark Python code. + The :doc:`@task.snowpark ` decorator is the Taskflow equivalent of ``SnowparkOperator`` to run Snowpark Python code. Prerequisite Tasks ^^^^^^^^^^^^^^^^^^