[DOCS] Adds new transform limitation item and a note to the tutorial (e…

…lastic#79479)
szabosteve · Oct 26, 2021 · e831b03 · e831b03
1 parent e862470
commit e831b03
Show file tree

Hide file tree

Showing 3 changed files with 22 additions and 3 deletions.
diff --git 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
@@ -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}.
+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>>.
diff --git 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