[GitHub] [airflow] drobert edited a comment on issue #18950: Basic tutorial example has many bugs

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

drobert edited a comment on issue #18950:
URL: https://github.com/apache/airflow/issues/18950#issuecomment-942711225


   > I think changing the title to "Basic tutorial examples could be improved". reflects a bit better the actual state of it
   
   @potiuk I did not intend to make this sound aggressive, but I will admit I don't think "might be a little out-dated or buggy" is accurate either. It is not possible this code or this data set was ever attempted, and it is admittedly a very frustrating experience for a new developer to fail at the given "hello world" example.
   
   There is no disrespect intended *at all* on the Airflow product or the countless hours dedicated engineers have given to its release. But in the context of the getting started tutorial, I felt this title was accurate without being accusatory. (It's not "horrible documentation" or "clearly the doc writers are lazy", but the tutorial is significantly full of bugs at just about every step.)
   
   I could see "Basic tutorial examples do not function", but "improvement" does not seem accurate. I was attempting to write this from the context of someone looking for whether there are open issues with the documentation (as I was).


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