potiuk edited a comment on issue #21457:
URL: https://github.com/apache/airflow/issues/21457#issuecomment-1034005672


   Thanks for posting those. But I will close the ticket because the main 
reason why you see the difference is because you are looking at "stable" 
version of the docs released together with Airflow when the stable version of 
Airflow is released (which is 2.2.3 currently) 
   
   So what is published in 2.2.3 version of the docs (which you can see at the 
top-left selection of the page) is this: 
https://github.com/apache/airflow/blob/2.2.3/docs/apache-airflow/tutorial.rst
   
   The `main` version of the docs is "development' version which might (or 
might not) be released with the new version. The changes you pointed at from 
`main` are actually cherry-picked to v2-2-test (which will become 2.2.4 soon - 
about a week - when we release it): 
https://github.com/apache/airflow/blob/v2-2-test/docs/apache-airflow/tutorial.rst
   
   I actually looked through all documentation-only changes we had in `main` 
(development versions) and might (or might not) contain improvements and new 
features. When the changes were just "improving" the documentation rather than 
adding new feature docs, i cherry-picked all such changes (and Jed - our 
release manager cherry-picked some before as well).   
   
   > I just thought that from airflow.hooks.postgres is wrong because it 
doesn't exist, or at least I didn't found it.
   
   This is indeed wrong. The easiest way to fix it is just go to the tutorial 
page and click "Suggest a change on this page" (bottomn-right of the page). It 
will open you the Pull Request with the "main" version of the page and you will 
be able to easily create a PR (even more easily than creating this issue was. 
You can this way become one of the > 1900 contributors to Airlfow (because 
Airflow is created by the contributors like you. This would be a fantastic 
first contribution to correct it! 
   
   > I don't know if this is the intended/optimal way to create the DB, but the 
DAG's run didn't fail. Maybe it would be easier for bloody beginners like me to 
include the part of creating the DB explicitly in the tutorial's code.
   
   You should follow [Quick 
start](https://airflow.apache.org/docs/apache-airflow/stable/start/index.html) 
if you are bloody beginner. This is who it is intended for. And It explains 
what happens and what is going on includng the steps to initialize DB (`airflow 
db init` is the right command), 
   
   
   
   
   


-- 
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]


Reply via email to