From e831b03dfc32a3b373ec851d8311a9f6d66db486 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Tue, 26 Oct 2021 10:14:58 +0200
Subject: [PATCH] [DOCS] Adds new transform limitation item and a note to the
 tutorial (#79479)

---
 docs/reference/transform/ecommerce-tutorial.asciidoc |  5 +++++
 docs/reference/transform/limitations.asciidoc        | 10 +++++++++-
 docs/reference/transform/overview.asciidoc           | 10 ++++++++--
 3 files changed, 22 insertions(+), 3 deletions(-)

diff --git a/docs/reference/transform/ecommerce-tutorial.asciidoc b/docs/reference/transform/ecommerce-tutorial.asciidoc
index 2e74dbeacfc9d..9c121a0f87d3f 100644
--- a/docs/reference/transform/ecommerce-tutorial.asciidoc
+++ b/docs/reference/transform/ecommerce-tutorial.asciidoc
@@ -241,6 +241,11 @@ destination index. In {kib}, if you copied the API request to your
 clipboard, paste it into the console, then refer to the `generated_dest_index` 
 object in the API response.
 
+NOTE: {transforms-cap} might have more configuration options provided by the 
+APIs than the options available in {kib}. For example, you can set an ingest 
+pipeline for `dest` by calling the <<put-transform>>. For all the {transform} 
+configuration options, refer to the <<transform-apis,documentation>>.
+
 .API example
 [%collapsible]
 ====
diff --git a/docs/reference/transform/limitations.asciidoc b/docs/reference/transform/limitations.asciidoc
index 367aef9cbee9c..a9c4a85f3699c 100644
--- a/docs/reference/transform/limitations.asciidoc
+++ b/docs/reference/transform/limitations.asciidoc
@@ -294,4 +294,12 @@ nodes have been upgraded to the newer version before using the {transforms} UI.
 [[transform-kibana-limitations]]
 === Up to 1,000 {transforms} are listed in {kib}
 
-The {transforms} management page in {kib} lists up to 1000 {transforms}.
\ No newline at end of file
+The {transforms} management page in {kib} lists up to 1000 {transforms}.
+
+[discrete]
+[[transform-ui-support]]
+=== {kib} might not support every {transform} configuration option
+
+There might be configuration options available via the {transform} APIs that are 
+not supported in {kib}. For an exhaustive list of configuration options, refer 
+to the <<transform-apis,documentation>>.
\ No newline at end of file
diff --git a/docs/reference/transform/overview.asciidoc b/docs/reference/transform/overview.asciidoc
index 78e24b071c40f..f2d177ceab544 100644
--- a/docs/reference/transform/overview.asciidoc
+++ b/docs/reference/transform/overview.asciidoc
@@ -8,8 +8,14 @@
 You can choose either of the following methods to transform your data:
 <<pivot-transform-overview,pivot>> or <<latest-transform-overview,latest>>.
 
-IMPORTANT: All {transforms} leave your source index intact. They create a new
-index that is dedicated to the transformed data.
+[IMPORTANT]
+====
+* All {transforms} leave your source index intact. They create a new
+  index that is dedicated to the transformed data.
+* {transforms-cap} might have more configuration options provided by the APIs 
+  than the options available in {kib}. For all the {transform} configuration 
+  options, refer to the <<transform-apis,API documentation>>.
+====
 
 {transforms-cap} are persistent tasks; they are stored in cluster state which 
 makes them resilient for node failures. Refer to <<transform-checkpoints>> and