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 0711d50597 More detail on mandatory task arguments (#35740)
0711d50597 is described below
commit 0711d50597fd0cfc5afd46dc9b7ff3e207b27d0a
Author: Cai Parry-Jones <[email protected]>
AuthorDate: Mon Nov 20 22:02:59 2023 +0000
More detail on mandatory task arguments (#35740)
* More detail on mandatory task arguments
Current documentation notes that the arguments 'task_id' and 'owner' are
both mandatory. This might confuse new users to believe that both arguments
require user input to avoid an error. But 'owner' has a default default_value,
so this argument should be less of a concern for user task and dag creation.
This commit aims to communicate that.
* fix typo
* Update fundamentals.rst
---------
Co-authored-by: Jarek Potiuk <[email protected]>
---
docs/apache-airflow/tutorial/fundamentals.rst | 7 +++++--
1 file changed, 5 insertions(+), 2 deletions(-)
diff --git a/docs/apache-airflow/tutorial/fundamentals.rst
b/docs/apache-airflow/tutorial/fundamentals.rst
index 2c710530b2..e68205aca9 100644
--- a/docs/apache-airflow/tutorial/fundamentals.rst
+++ b/docs/apache-airflow/tutorial/fundamentals.rst
@@ -146,8 +146,11 @@ The precedence rules for a task are as follows:
2. Values that exist in the ``default_args`` dictionary
3. The operator's default value, if one exists
-A task must include or inherit the arguments ``task_id`` and ``owner``,
-otherwise Airflow will raise an exception.
+.. note::
+ A task must include or inherit the arguments ``task_id`` and ``owner``,
+ otherwise Airflow will raise an exception. A fresh install of Airflow will
+ have a default value of 'airflow' set for ``owner``, so you only really
need
+ to worry about ensuring ``task_id`` has a value.
Templating with Jinja
---------------------
