Skip to content

Confusing Docs re: "Public Interface for DAG Authors" and No Link to Asset, etc #60996

@fritz-astronomer

Description

@fritz-astronomer

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

Are you willing to submit PR?

  • Yes I am willing to submit a PR!

Code of Conduct

Metadata

Metadata

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions