apache / airflow

Apache Airflow - A platform to programmatically author, schedule, and monitor workflows
https://airflow.apache.org/
Apache License 2.0
37.12k stars 14.31k forks source link

Docs: Replace `airflow.sdk.definitions` to `airflow.sdk` for public facing docs #43010

Open kaxil opened 1 month ago

kaxil commented 1 month ago

Currently the code lives in the following, which is right

from airflow.sdk.definitions.dag import DAG as DAG

but we want users to just see from airflow.sdk import DAG

So we might have to write a Sphinx extension to not show first one and just second one (intended for public usage)

Bowrna commented 1 month ago

can i pick this one @kaxil ?

kaxil commented 1 month ago

Hey @Bowrna , this one is still a tricky one and will evolve based on https://github.com/apache/airflow/issues/43011

But once https://github.com/apache/airflow/issues/43011 is done, absolutely.

Bowrna commented 1 month ago

@kaxil let me keep an eye on that one.