jedcunningham commented on code in PR #29062:
URL: https://github.com/apache/airflow/pull/29062#discussion_r1083133413
##########
docs/apache-airflow/core-concepts/params.rst:
##########
@@ -42,15 +42,31 @@ Use a dictionary that maps Param names to a either a
:class:`~airflow.models.par
"x": Param(5, type="integer", minimum=3),
"y": 6
},
- ) as the_dag:
+ ):
+
+Task-level Params
+-----------------
+
+You can also add Params to individual tasks.
+
+.. code-block::
+
+ PythonOperator(
+ task_id="print_x",
+ params={"x": 10},
+ python_callable=print_it,
+ )
+
+Task-level params take precedence over DAG-level params, and user-supplied
params (when triggering the DAG)
+take precedence over task-level params.
Referencing Params in a Task
----------------------------
-Params are stored as ``params`` in the :ref:`template context <templates-ref>`.
-So you can reference them in a template.
+Params can be referenced in :ref:`templated strings <templates-ref>`. For
example:
Review Comment:
```suggestion
Params can be referenced in :ref:`templated strings <templates-ref>` under
``params``. For example:
```
I think this is a key part, but feel free to reword it.
--
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: commits-unsubscr...@airflow.apache.org
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
