This is an automated email from the ASF dual-hosted git repository.
jason810496 pushed a commit to branch v3-4-test
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/v3-4-test by this push:
new 499f3b06492 [v3-4-test] Keep the language SDKs marked experimental in
the docs (#76584)
499f3b06492 is described below
commit 499f3b064921946129b3f69a51370de00e1179f5
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
