[GitHub] [airflow] potiuk commented on issue #21457: HTML of Pipeline example in tutorial incomplete

[GitBox <gi...@apache.org>]

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


   Thanks for posting those. But I will cloe 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 versio 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 when they 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" - it will open you the PR 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: commits-unsubscribe@airflow.apache.org

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