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 faba410b325d8..7272444cba383 100644
--- a/airflow-core/docs/authoring-and-scheduling/language-sdks/index.rst
+++ b/airflow-core/docs/authoring-and-scheduling/language-sdks/index.rst
@@ -122,6 +122,13 @@ XCom references should be defined inside the Python Dag (they are task dependenc
 actually read the values out in the language implementation, and vice versa. See specific language SDK
 documentation on how to do this correctly.
 
+.. note::
+
+    For a Dag containing stub tasks, the **Code** view in the Airflow UI shows only the Python Dag
+    file — including the stub declarations — as the Dag's source. The non-Python implementation source
+    is not displayed anywhere in the UI; consult your project repository or the build artifact shipped
+    in the bundle to inspect it. This is an intentional architecture decision, not a bug.
+
 .. _language-sdks/coordinator-config:
 
 Coordinator configuration