This is an automated email from the ASF dual-hosted git repository. vatsrahul1001 pushed a commit to branch v3-4-test in repository https://gitbox.apache.org/repos/asf/airflow.git
commit 0ba536620ea09de9b00e32c34ae8e57e67ec8b8f Author: Jason(Zhe-You) Liu <[email protected]> AuthorDate: Fri Nov 6 17:50:34 2026 +0800 [v3-4-test] Keep the language SDKs marked experimental in the docs (#76584) The language SDKs stay experimental in Airflow 3.4 even though their packages reach 1.0.0, so the docs should keep saying their API may change. --- airflow-core/docs/authoring-and-scheduling/language-sdks/index.rst | 2 ++ airflow-core/docs/authoring-and-scheduling/language-sdks/java.rst | 2 ++ .../docs/authoring-and-scheduling/language-sdks/typescript.rst | 5 ++++- ts-sdk/README.md | 2 +- ts-sdk/docs/index.md | 3 ++- 5 files changed, 11 insertions(+), 3 deletions(-) diff --git a/airflow-core/docs/authoring-and-scheduling/language-sdks/index.rst b/airflow-core/docs/authoring-and-scheduling/language-sdks/index.rst index d5816f1fef5..ea8d4b8448d 100644 --- a/airflow-core/docs/authoring-and-scheduling/language-sdks/index.rst +++ b/airflow-core/docs/authoring-and-scheduling/language-sdks/index.rst @@ -20,6 +20,8 @@ Non-Python Task SDKs ==================== +|experimental| + Airflow Dags and tasks can be written in languages other than Python. A language SDK is used in one of two ways: diff --git a/airflow-core/docs/authoring-and-scheduling/language-sdks/java.rst b/airflow-core/docs/authoring-and-scheduling/language-sdks/java.rst index e0070b701b0..0cc9981b52d 100644 --- a/airflow-core/docs/authoring-and-scheduling/language-sdks/java.rst +++ b/airflow-core/docs/authoring-and-scheduling/language-sdks/java.rst @@ -20,6 +20,8 @@ Java SDK ======== +|experimental| + The Java SDK lets you write Airflow Dags and tasks in Java, Kotlin, Scala or any other JVM language. There are two ways to use it: diff --git a/airflow-core/docs/authoring-and-scheduling/language-sdks/typescript.rst b/airflow-core/docs/authoring-and-scheduling/language-sdks/typescript.rst index e11046f6597..e95dc911859 100644 --- a/airflow-core/docs/authoring-and-scheduling/language-sdks/typescript.rst +++ b/airflow-core/docs/authoring-and-scheduling/language-sdks/typescript.rst @@ -20,6 +20,8 @@ TypeScript SDK ============== +|experimental| + The TypeScript SDK lets you write Airflow Dags and tasks in TypeScript, or plain JavaScript, and run them on Node.js. There are two ways to use it: @@ -30,7 +32,7 @@ Node.js. There are two ways to use it: Both use the same task API and the same build tool, and one bundle can serve both. -The SDK is the ``@apache-airflow/ts-sdk`` npm package (ESM-only). +The SDK is the ``@apache-airflow/ts-sdk`` npm package (ESM-only). Its API may change. .. warning:: @@ -889,5 +891,6 @@ Limitations run when the Dag processor reads them. * **Some CLI commands do not take a Dag declared in TypeScript.** ``airflow dags test``, ``tasks test`` and ``tasks render`` refuse it, and ``airflow dags reserialize`` skips it. +* **Experimental.** The API may change in incompatible ways between releases. * **One Node.js process per task instance.** Tasks cannot share in-process state; use XComs or an external store. diff --git a/ts-sdk/README.md b/ts-sdk/README.md index b80d037109f..cb97f2db8f9 100644 --- a/ts-sdk/README.md +++ b/ts-sdk/README.md @@ -21,7 +21,7 @@ Write Apache Airflow Dags in TypeScript, and run them on Node.js. -**Status:** 1.0.0 · Node 22+ · ESM-only +**Status:** 1.0.0 · API may change · Node 22+ · ESM-only ## Installation diff --git a/ts-sdk/docs/index.md b/ts-sdk/docs/index.md index eab62992ede..78639fe0374 100644 --- a/ts-sdk/docs/index.md +++ b/ts-sdk/docs/index.md @@ -22,7 +22,8 @@ Write Apache Airflow Dags in TypeScript, and run them on Node.js. > **Note** -> This package is **1.0.0**. It requires **Node 22+** and is **ESM-only**. +> This package is **1.0.0**: the API may change, it requires **Node 22+**, and +> it is **ESM-only**. ## Quick Start
