GitHub user eladkal added a comment to the discussion: Docs: Make Taskflow-centric
> 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 come 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 GitHub link: https://github.com/apache/airflow/discussions/48633#discussioncomment-12690315 ---- This is an automatically sent email for [email protected]. To unsubscribe, please send an email to: [email protected]
