From 91f73fa783f76564e4bd5e6c0cc0aa9a1228c83d Mon Sep 17 00:00:00 2001
From: CJ Cenizal <cj@cenizal.com>
Date: Tue, 14 Jan 2020 15:17:08 -0800
Subject: [PATCH 1/3] Improve data type descriptions.

---
 .../constants/data_types_definition.tsx            | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/x-pack/legacy/plugins/index_management/public/app/components/mappings_editor/constants/data_types_definition.tsx b/x-pack/legacy/plugins/index_management/public/app/components/mappings_editor/constants/data_types_definition.tsx
index 6abf1dd004f3b..382e9b6c7242a 100644
--- a/x-pack/legacy/plugins/index_management/public/app/components/mappings_editor/constants/data_types_definition.tsx
+++ b/x-pack/legacy/plugins/index_management/public/app/components/mappings_editor/constants/data_types_definition.tsx
@@ -54,7 +54,7 @@ export const TYPE_DEFINITION: { [key in DataType]: DataTypeDefinition } = {
       <p>
         <FormattedMessage
           id="xpack.idxMgmt.mappingsEditor.dataType.keywordLongDescription"
-          defaultMessage="Keyword fields support search by their exact value. This data type is useful for filtering, sorting, and aggregations. To index full-text content, such as an email body, use the {textType}."
+          defaultMessage="Keyword fields support searching for an exact value and are useful for filtering, sorting, and aggregations. To index full-text content, such as an email body, use the {textType}."
           values={{
             textType: (
               <EuiLink href={documentationService.getTypeDocLink('text')} target="_blank">
@@ -417,7 +417,7 @@ export const TYPE_DEFINITION: { [key in DataType]: DataTypeDefinition } = {
       <p>
         <FormattedMessage
           id="xpack.idxMgmt.mappingsEditor.dataType.denseVectorLongDescription"
-          defaultMessage="Dense vector fields store dense vectors of float values. This data type is useful for document scoring."
+          defaultMessage="Dense vector fields store vectors of float values, useful for document scoring."
         />
       </p>
     ),
@@ -568,7 +568,7 @@ export const TYPE_DEFINITION: { [key in DataType]: DataTypeDefinition } = {
       <p>
         <FormattedMessage
           id="xpack.idxMgmt.mappingsEditor.dataType.completionSuggesterLongDescription"
-          defaultMessage="Completion suggester fields support autocomplete functionality. This data type uses data structures to enable fast lookups, but are costly to build and stored in-memory."
+          defaultMessage="Completion suggester fields support autocomplete, but require special data structures that occupy memory and build slowly."
         />
       </p>
     ),
@@ -585,7 +585,7 @@ export const TYPE_DEFINITION: { [key in DataType]: DataTypeDefinition } = {
       <p>
         <FormattedMessage
           id="xpack.idxMgmt.mappingsEditor.dataType.tokenCountLongDescription"
-          defaultMessage="Token count fields accept string values. These values are analyzed, then the number of tokens in the string are indexed."
+          defaultMessage="Token count fields accept string values and indexes the number of analyzed tokens in the string."
         />
       </p>
     ),
@@ -620,7 +620,7 @@ export const TYPE_DEFINITION: { [key in DataType]: DataTypeDefinition } = {
       <p>
         <FormattedMessage
           id="xpack.idxMgmt.mappingsEditor.dataType.aliasLongDescription"
-          defaultMessage="Alias fields accept an alternative name for a field in the index. Aliases can be used in place of the target field in search requests."
+          defaultMessage="Alias fields accept an alternative name for a field, which you can use in search requests."
         />
       </p>
     ),
@@ -637,7 +637,7 @@ export const TYPE_DEFINITION: { [key in DataType]: DataTypeDefinition } = {
       <p>
         <FormattedMessage
           id="xpack.idxMgmt.mappingsEditor.dataType.searchAsYouTypeLongDescription"
-          defaultMessage="Search-as-you-type fields supports as-you-type search by breaking strings into a series of subfields. Both prefix completion and infix completion are supported."
+          defaultMessage="Search-as-you-type fields break strings into subfields for search suggestions, and will match terms at any position in the string."
         />
       </p>
     ),
@@ -654,7 +654,7 @@ export const TYPE_DEFINITION: { [key in DataType]: DataTypeDefinition } = {
       <p>
         <FormattedMessage
           id="xpack.idxMgmt.mappingsEditor.dataType.flattenedLongDescription"
-          defaultMessage="Flattened fields map an entire field as a single object. This data type is useful for indexing objects with a large or unknown number of unique keys. Flattened fields only support basic queries."
+          defaultMessage="Flattened fields map an object as a single field and are useful for indexing objects with a large or unknown number of unique keys. Flattened fields support basic queries only."
         />
       </p>
     ),

From 86bc84692f1a1c3f13b48f593057a6540a5d613c Mon Sep 17 00:00:00 2001
From: CJ Cenizal <cj@cenizal.com>
Date: Tue, 14 Jan 2020 15:20:46 -0800
Subject: [PATCH 2/3] Refine token count.

---
 .../mappings_editor/constants/data_types_definition.tsx         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/x-pack/legacy/plugins/index_management/public/app/components/mappings_editor/constants/data_types_definition.tsx b/x-pack/legacy/plugins/index_management/public/app/components/mappings_editor/constants/data_types_definition.tsx
index 382e9b6c7242a..6a0cba3193d58 100644
--- a/x-pack/legacy/plugins/index_management/public/app/components/mappings_editor/constants/data_types_definition.tsx
+++ b/x-pack/legacy/plugins/index_management/public/app/components/mappings_editor/constants/data_types_definition.tsx
@@ -585,7 +585,7 @@ export const TYPE_DEFINITION: { [key in DataType]: DataTypeDefinition } = {
       <p>
         <FormattedMessage
           id="xpack.idxMgmt.mappingsEditor.dataType.tokenCountLongDescription"
-          defaultMessage="Token count fields accept string values and indexes the number of analyzed tokens in the string."
+          defaultMessage="Token count fields accept string values and index their analyzed tokens."
         />
       </p>
     ),

From db7e4d65574b3069fdc55e62b4cee90ecfa1924f Mon Sep 17 00:00:00 2001
From: CJ Cenizal <cj@cenizal.com>
Date: Tue, 14 Jan 2020 15:45:38 -0800
Subject: [PATCH 3/3] Apply feedback.

---
 .../mappings_editor/constants/data_types_definition.tsx         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/x-pack/legacy/plugins/index_management/public/app/components/mappings_editor/constants/data_types_definition.tsx b/x-pack/legacy/plugins/index_management/public/app/components/mappings_editor/constants/data_types_definition.tsx
index 6a0cba3193d58..3823c4653bfc0 100644
--- a/x-pack/legacy/plugins/index_management/public/app/components/mappings_editor/constants/data_types_definition.tsx
+++ b/x-pack/legacy/plugins/index_management/public/app/components/mappings_editor/constants/data_types_definition.tsx
@@ -585,7 +585,7 @@ export const TYPE_DEFINITION: { [key in DataType]: DataTypeDefinition } = {
       <p>
         <FormattedMessage
           id="xpack.idxMgmt.mappingsEditor.dataType.tokenCountLongDescription"
-          defaultMessage="Token count fields accept string values and index their analyzed tokens."
+          defaultMessage="Token count fields accept string values.  These values are analyzed, and the number of tokens in the string are indexed."
         />
       </p>
     ),