datatalking opened a new issue, #28295:
URL: https://github.com/apache/airflow/issues/28295

   ### What do you see as an issue?
   
   
   This is my first errata for the docs and under the 'Instantiate a DAG' 
section it mentions 
[(https://github.com/apache/airflow/tree/main/docs/apache-airflow/tutorial)/fundamentals.rst](https://github.com/apache/airflow/blob/main/docs/apache-airflow/tutorial/fundamentals.rst#instantiate-a-dag)
   
   '''
   We'll need a DAG object to nest our tasks into. Here we pass a string that 
defines the `dag_id`, which serves as a unique identifier for your DAG. We also 
pass the default argument dictionary that we just defined and define a schedule 
of 1 day for the DAG
   ```
   
   It mentions the `dag_id` but never shows it or mentions it again until the 
bottom section under Tests.
   
   Should it be declared or used somehow?
   
   I'm doing a fresh install on MacOs and there are so many little flags and 
issues I'm looking for a more thorough install. I bought the `Data Engineering 
with Python` book from PacktPub from Paul Crickard and so much has changed the 
book is becoming less and less helpful.
   
   ### Solving the problem
   
   Should the `dag_id` object or whatever it is be declared, referenced, shown 
what it is or how can we be verbose on what it is? A search on that page 
'https://airflow.apache.org/docs/apache-airflow/stable/tutorial/fundamentals.html'
 shows only two mentions of `dag_id` SO I figured this was an oversight and I'm 
willing to help fill in or be verbose in explaining it.
   
   ### Anything else
   
   Once I know the purpose or have context on what `dag_id` is or can be 
explained as I'm willing to submit a PR.
   
   ### Are you willing to submit PR?
   
   - [X] Yes I am willing to submit a PR!
   
   ### Code of Conduct
   
   - [X] I agree to follow this project's [Code of 
Conduct](https://github.com/apache/airflow/blob/main/CODE_OF_CONDUCT.md)
   


-- 
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.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org

Reply via email to