fritz-astronomer opened a new issue, #60996: URL: https://github.com/apache/airflow/issues/60996
### What do you see as an issue? https://airflow.apache.org/docs/apache-airflow/stable/public-airflow-interface.html#using-the-public-interface-for-dag-authors On this page, the link in the first sentence > The primary interface for Dag authors is the [airflow.sdk namespace](https://airflow.apache.org/docs/apache-airflow/stable/core-concepts/taskflow.html). links to Taskflow docs. In my opinion, it should link to the best like for the `airflow.sdk` namespace, preferably python sdk docs. Additionally, these references are all non-functional, but should link to the python objects they describe ``` Classes: Asset BaseHook BaseNotifier BaseOperator BaseOperatorLink BaseSensorOperator Connection Context DAG EdgeModifier Label ObjectStoragePath Param TaskGroup Variable ``` ``` Decorators and Functions: @asset @dag @setup @task @task_group @teardown chain chain_linear cross_downstream get_current_context get_parsing_context ``` ### Solving the problem _No response_ ### Anything else _No response_ ### Are you willing to submit PR? - [ ] Yes I am willing to submit a PR! ### Code of Conduct - [x] I agree to follow this project's [Code of Conduct](https://github.com/apache/airflow/blob/main/CODE_OF_CONDUCT.md) -- 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]
