dstandish commented on code in PR #46875:
URL: https://github.com/apache/airflow/pull/46875#discussion_r1960796692
##########
docs/apache-airflow/core-concepts/dags.rst:
##########
@@ -20,7 +20,15 @@
DAGs
====
-A *DAG* (Directed Acyclic Graph) is the core concept of Airflow, collecting
:doc:`tasks` together, organized with dependencies and relationships to say how
they should run.
+A *DAG* is the core concept of Airflow. A DAG is a model that encapsulates
everything needed to execute a workflow:
+
+* **Schedule**: When the workflow should run.
+* **Task Dependencies**: The order and conditions under which :doc:`tasks`
execute.
+* **Completion Behavior**: Actions to take when the entire workflow completes.
+* **Error Handling**: Actions to take when a task fails.
+* **Additional Parameters**: And many other operational details.
+
+The term "DAG" comes from the mathematical concept "directed acyclic graph",
but the meaning in Airflow has evolved well beyond just the literal data
structure associated with the mathematical DAG concept.
Review Comment:
I would also move this to the _end_ of this section i.e. just before
`Declaring a DAG`
```suggestion
.. note::
The name of the Airflow ``DAG`` object comes from the mathematical
concept "directed acyclic graph".
But people find this confusing and we don't really recommend thinking
about that.
Directed simply means that the tasks have an upstream / downstream
relationship.
Acyclic means that a task cannot be downstream of itself -- there can be
no cycles.
```
--
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]
