From afe7869b198da9085cdd2a822fdd33dc1e9d5b96 Mon Sep 17 00:00:00 2001
From: Kaarina Tungseth <kaarina.tungseth@elastic.co>
Date: Thu, 9 Sep 2021 11:53:37 -0500
Subject: [PATCH] [DOCS] Adds preview to runtime fields (#110327) (#111764)

* [DOCS] Adds preview to runtime fields

* Final draft changes

* Review comments
---
 ...ent-indexPatterns-pinRuntimeField-7.15.png | Bin 0 -> 4334 bytes
 .../management/manage-index-patterns.asciidoc |  46 +++++++++---------
 2 files changed, 23 insertions(+), 23 deletions(-)
 create mode 100644 docs/management/images/stackManagement-indexPatterns-pinRuntimeField-7.15.png

diff --git a/docs/management/images/stackManagement-indexPatterns-pinRuntimeField-7.15.png b/docs/management/images/stackManagement-indexPatterns-pinRuntimeField-7.15.png
new file mode 100644
index 0000000000000000000000000000000000000000..49d0d4caec00f8dd1c3cd246dbfabe07104fdc51
GIT binary patch
literal 4334
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%0DOst7C-g{?_m
zT=*C1-;V!EwD_ASCizd|KOFxcUKIc~@I_!(>2S4!@*)t>|FQiWZv;bmdH7$!O_2yc
zdC^~#f0=)=AfT&5`Ntvs?0_FuYzxQ}LqNaVNuHSTRQ(mU`JQR1Dw$}K)tL0VQ!CM2
z1V~vXduCX0xt>sH=B?-rCyXSsDc|GUUkK0rte^y9p;78>i6Y#YeJ!VIeV59R^75Md
z`)Uq#KJKs1;V07`QrVmOQl{H2>pgw%w=$2Kg2XcBPuMS_7s=;H+bAbLrWYY*Q^h4j
zb{2gJ_N&9GD5l5vqCSVjKYuAs3e4^^sGjhILU6NGeUqA4bInQ}g6mWJ5+zb626mMD
zDcWSwTRy^06N~(#t=aY;@MAF|=6sGL2`?|+zl-}i?EhKc?62c6(K{H}bdSUN0ikpv
z&~};haMGy#2@QB@b$NU4n1C-u3%CC6gQ@E|EopD8>uUUf9gf$Pl;L`&NZs-^f{b2n
zBxtJrm?Z5EMJ%T;_tf}BWWt_5By1l_DW)!|&E~nTYN4ygOq&2+zJ24*FJCc+w+-@5
zDtX6M>lPYV*&~Bif}XgZI<W^KT6@+C{xA?U8S&xvam*P6rJ<i4x5Qi+w7+B)CD5L;
zs9K0@hX|0(Xxq8iBeiBs-tDx|kQB{U2<Yrnn?3Qv3zo~|%Z=bHikt7$&S&g_WQ$rV
zHteLgZ^f$KOtJVd)7jnq%G<SO1kW|p({$fuZ7=W=sq*l6uTr+Tr{^{)0Z^QgtbUwl
zw*LA%Rmd)nQFfN6fPhWM+?+qAnb!NVg&JZT7VDORe7S6Rf>S@m@|vGqq-nxuD;TG%
zu=cAM>aWAMTit3ochbG^^Mw5hbozIan#<SXr)xd8{k>xcKWMs)@{FV{KQk&pT0uJH
z(x{F^uP1jE2}pfaVllA5KbAtBnYZW2H<>n(ykaKT>-poYU8B-F8#;+nj^yQM{YC3+
xkN0GP16LO6_AB>cJ$amP7d{^L4r!yqb0EeNQR*xkarHL_XsPL|mMh<h`VWe<pm+cP

literal 0
HcmV?d00001

diff --git a/docs/management/manage-index-patterns.asciidoc b/docs/management/manage-index-patterns.asciidoc
index ac07aa833c3b..08527ffa75d4 100644
--- a/docs/management/manage-index-patterns.asciidoc
+++ b/docs/management/manage-index-patterns.asciidoc
@@ -7,60 +7,60 @@ To customize the data fields in your index pattern, you can add runtime fields t
 [[runtime-fields]]
 === Explore your data with runtime fields 
 
-Runtime fields are fields that you add to documents after you've ingested, and are evaluated at query time. With runtime fields, you allow for a smaller index and faster ingest time so that you can use less resources and reduce your operating costs. You can use runtime fields anywhere index patterns are used.
+Runtime fields are fields that you add to documents after you've ingested your data, and are evaluated at query time. With runtime fields, you allow for a smaller index and faster ingest time so that you can use less resources and reduce your operating costs. You can use runtime fields anywhere index patterns are used, for example, you can explore runtime fields in *Discover* and create visualizations with runtime fields for your dashboard.
 
-When you use runtime fields, you can:
+With runtime fields, you can:
 
-* Define fields for a specific use without modifying the underlying schema. 
+* Define fields for a specific use case without modifying the underlying schema. 
 
 * Override the returned values from index fields.
 
-* Start working on your data without first understanding the structure. 
+* Start working on your data without understanding the structure. 
 
 * Add fields to existing documents without reindexing your data. 
 
-* Explore runtime field data in *Discover*.
-
-* Create visualizations with runtime field data using *Lens*, *Maps*, and *TSVB*.
-
 WARNING: Runtime fields can impact {kib} performance. When you run a query, {es} uses the fields you index first to shorten the response time. 
 Index the fields that you commonly search for and filter on, such as `timestamp`, then use runtime fields to limit the number of fields {es} uses to calculate values. 
 
-For more information, refer to {ref}/runtime.html[Runtime fields].
+For detailed information on how to use runtime fields with {es}, refer to {ref}/runtime.html[Runtime fields].
 
 [float]
 [[create-runtime-fields]]
-==== Create runtime fields
+==== Add runtime fields
 
-Create runtime fields in your index patterns, or create runtime fields in *Discover* and *Lens*. 
+To add runtime fields to your index patterns, open the index pattern you want to change, then define the field values by emitting a single value using the {ref}/modules-scripting-painless.html[Painless scripting language]. You can also add runtime fields in <<add-field-in-discover,*Discover*>> and <<change-the-fields,*Lens*>>.
 
 . Open the main menu, then click *Stack Management > Index Patterns*.
 
 . Select the index pattern you want to add the runtime field to, then click *Add field*.
 
-. Enter a *Name* for the runtime field, then select the field *Type*.
+. Enter the field *Name*, then select the *Type*.
 
-. Select *Set value*, then define the field value by emitting a single value using the {ref}/modules-scripting-painless.html[Painless scripting language].
-+
-The script must match the field *Type*, or the script fails.
+. Select *Set custom label*, then enter the label you want to display where the index pattern is used, such as *Discover*.
+
+. Select *Set value*, then define the script. The script must match the *Type*, or the index pattern fails anywhere it is used.
+
+. To help you define the script, use the *Preview*:
+
+* To view the other available fields, use the *Document ID* arrows.
+
+* To filter the fields list, enter the keyword in *Filter fields*.
+
+* To pin frequently used fields to the top of the list, hover over the field, then click image:images/stackManagement-indexPatterns-pinRuntimeField-7.15.png[Icon to pin field to the top of the list].
 
 . Click *Create field*.
-+
-For information on how to create runtime fields in *Discover*, refer to <<add-field-in-discover,Add a field>>.
-+
-For information on how to create runtime fields in *Lens*, refer to <<change-the-fields,Change the fields list>>.
 
 [float]
 [[runtime-field-examples]]
 ==== Runtime field examples
 
-Try the runtime field examples on your own using the *Sample web logs* data index pattern. 
+Try the runtime field examples on your own using the <<gs-get-data-into-kibana,*Sample web logs*>> data index pattern. 
 
 [float]
 [[simple-hello-world-example]]
 ==== Return a keyword value
 
-To return `Hello World!` value:
+Return `Hello World!`:
 
 [source,text]
 ----
@@ -101,7 +101,7 @@ emit("");
 [[replace-nulls-with-blanks]]
 ===== Replace nulls with blanks
 
-Replace null values with none values:
+Replace `null` values with `None`:
 
 [source,text]
 ----
@@ -115,7 +115,7 @@ else {
 }
 ----
 
-Specify operating system condition:
+Specify the operating system condition:
 
 [source,text]
 ----