eladkal commented on issue #48608:
URL: https://github.com/apache/airflow/issues/48608#issuecomment-2768416020

   > Assuming Taskflow is the recommended paradigm for new users,
   
   Generally speaking i am not so convinced about this. taskflow is an option. 
It's not necessarily the favorite.
   It has pros and cons.
   
   In any case the overview page can not use taskflow. Airflow docs are built 
as a "story" not as individual pages. You can use taskflow only in pages that 
comes after the taskflow page.
   
   Also noting in the overview/concept pages we are looking for the simplest 
way to present dag authoring options. In my perspective this specific does are 
aiming for the lowest common ground of data professionals. Task decorators 
while offer simpler code (less lines etc...) are not in that domain because you 
need to understand what Python decorators are and how they operate (Unlike OOP 
concepts which we can safely assume everyone are familiar with it). Only later 
in the docs we can aim higher by introducing more "complex" stuff that simplify 
dag authoring.
   
   Happy to hear your take on this one. Docs are for the users of Airflow if 
you believe we should take different approach we are happy to hear feedback. cc 
@cmarteepants as author of #45649


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