From 29b557344325de1a7acbea01c15dd98db6e9f0e1 Mon Sep 17 00:00:00 2001 From: Przemyslaw Witek Date: Mon, 24 Oct 2022 12:15:02 +0200 Subject: [PATCH 1/4] Expand the paragraph regarding mappings deduction in transform's dest index --- docs/reference/rest-api/common-parms.asciidoc | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/reference/rest-api/common-parms.asciidoc b/docs/reference/rest-api/common-parms.asciidoc index d8b10dadd0de4..ff9d1d3b65a72 100644 --- a/docs/reference/rest-api/common-parms.asciidoc +++ b/docs/reference/rest-api/common-parms.asciidoc @@ -148,11 +148,18 @@ The destination for the {transform}. end::dest[] tag::dest-index[] -The _destination index_ for the {transform}. The mappings of the destination +The _destination index_ for the {transform}. +In case of a `pivot` transform, the mappings of the destination index are deduced based on the source fields when possible. If alternate mappings are required, use the https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-create-index.html[Create index API] prior to starting the {transform}. +In case of a `latest` transform, the mappings are never deduced. If dynamic +mappings for the destination index are undesirable, use the +https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-create-index.html[Create index API] +prior to starting the {transform}. + + end::dest-index[] tag::dest-pipeline[] From 50ea4d5bf54a8582a531f91431efd8c2467fcc1f Mon Sep 17 00:00:00 2001 From: Przemyslaw Witek Date: Mon, 24 Oct 2022 12:18:04 +0200 Subject: [PATCH 2/4] Remove excessive blank lines --- docs/reference/rest-api/common-parms.asciidoc | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/reference/rest-api/common-parms.asciidoc b/docs/reference/rest-api/common-parms.asciidoc index ff9d1d3b65a72..2e212e7a96a08 100644 --- a/docs/reference/rest-api/common-parms.asciidoc +++ b/docs/reference/rest-api/common-parms.asciidoc @@ -158,8 +158,6 @@ In case of a `latest` transform, the mappings are never deduced. If dynamic mappings for the destination index are undesirable, use the https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-create-index.html[Create index API] prior to starting the {transform}. - - end::dest-index[] tag::dest-pipeline[] From cf6b1e1691d5fc8e21bc43800ace87392f755ea5 Mon Sep 17 00:00:00 2001 From: Przemyslaw Witek Date: Mon, 24 Oct 2022 13:19:16 +0200 Subject: [PATCH 3/4] Use short links instead of full links --- docs/reference/rest-api/common-parms.asciidoc | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/reference/rest-api/common-parms.asciidoc b/docs/reference/rest-api/common-parms.asciidoc index 2e212e7a96a08..48094ed2ef974 100644 --- a/docs/reference/rest-api/common-parms.asciidoc +++ b/docs/reference/rest-api/common-parms.asciidoc @@ -149,15 +149,15 @@ end::dest[] tag::dest-index[] The _destination index_ for the {transform}. + In case of a `pivot` transform, the mappings of the destination index are deduced based on the source fields when possible. If alternate -mappings are required, use the -https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-create-index.html[Create index API] +mappings are required, use the <> prior to starting the {transform}. + In case of a `latest` transform, the mappings are never deduced. If dynamic mappings for the destination index are undesirable, use the -https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-create-index.html[Create index API] -prior to starting the {transform}. +<> prior to starting the {transform}. end::dest-index[] tag::dest-pipeline[] From ac43d30eebc2924f29c374eaad340e902c640f30 Mon Sep 17 00:00:00 2001 From: Przemyslaw Witek Date: Mon, 24 Oct 2022 13:23:05 +0200 Subject: [PATCH 4/4] Apply review suggestions --- docs/reference/rest-api/common-parms.asciidoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/reference/rest-api/common-parms.asciidoc b/docs/reference/rest-api/common-parms.asciidoc index 48094ed2ef974..fbf062be959a3 100644 --- a/docs/reference/rest-api/common-parms.asciidoc +++ b/docs/reference/rest-api/common-parms.asciidoc @@ -150,12 +150,12 @@ end::dest[] tag::dest-index[] The _destination index_ for the {transform}. -In case of a `pivot` transform, the mappings of the destination +In the case of a `pivot` transform, the mappings of the destination index are deduced based on the source fields when possible. If alternate mappings are required, use the <> prior to starting the {transform}. -In case of a `latest` transform, the mappings are never deduced. If dynamic +In the case of a `latest` transform, the mappings are never deduced. If dynamic mappings for the destination index are undesirable, use the <> prior to starting the {transform}. end::dest-index[]