diff --git a/airflow-core/docs/public-airflow-interface.rst b/airflow-core/docs/public-airflow-interface.rst index b0b7cfe5af23a..0f685c16ccea4 100644 --- a/airflow-core/docs/public-airflow-interface.rst +++ b/airflow-core/docs/public-airflow-interface.rst @@ -47,6 +47,21 @@ For comprehensive Task SDK documentation, see the `Task SDK Reference `_. + + Direct interaction with internal modules or the metadata database is not possible. + For stable, production-safe integration, it is recommended to use: + + - The official **REST API** + - The **Python Client SDK** (`airflow-client-python`) + - The new **Task SDK** (``airflow.sdk``) + + Related docs: + - `Release Notes 3.0 `_ + - `Task SDK Overview `_ + The following are some examples of the public interface of Airflow: * When you are writing your own operators or hooks. This is commonly done when no hook or operator exists for your use case, or when perhaps when one exists but you need to customize the behavior.