Varshitha9115 commented on issue #60996:
URL: https://github.com/apache/airflow/issues/60996#issuecomment-3793132980

   Hii @fritz-astronomer
   
   Thanks for raising this — I agree the current wording is a bit confusing for 
DAG authors.
   
   On the linked page, the first sentence points to the TaskFlow docs, but the 
text refers to the `airflow.sdk` namespace. It might be clearer if this linked 
directly to the Python SDK documentation for `airflow.sdk`, or explicitly 
explained why TaskFlow is the recommended entry point.
   
   Also +1 to the note about the class references — linking each listed class 
(e.g., Asset, BaseOperator, DAG, TaskGroup) directly to their corresponding 
Python API docs would make this page much more actionable for users.
   
   Happy to help clarify or test any proposed doc updates.
   


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