baolsen commented on a change in pull request #6999: [AIRFLOW-XXXX] Clarify wait_for_downstream and execution_date URL: https://github.com/apache/airflow/pull/6999#discussion_r362744996
########## File path: docs/concepts.rst ########## @@ -33,6 +33,9 @@ In Airflow, a ``DAG`` -- or a Directed Acyclic Graph -- is a collection of all the tasks you want to run, organized in a way that reflects their relationships and dependencies. +A DAG is defined in a Python script, which represents the DAGs structure (tasks +and their dependencies) as code. Review comment: While this is mentioned later on, it is a concept that is often misunderstood (even the tutorial had to emphasise this). I still have colleagues who don't realize a DAG is actually code... ---------------------------------------------------------------- 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. For queries about this service, please contact Infrastructure at: [email protected] With regards, Apache Git Services
