[DOCS] Improve/fix documentation on stored scripts (elastic#119921)

* Improve/fix documentation on stored scripts * Update docs/reference/scripting/using.asciidoc Co-authored-by: Liam Thompson <[email protected]> * Update docs/reference/scripting/using.asciidoc Co-authored-by: Liam Thompson <[email protected]> * Update docs/reference/transform/painless-examples.asciidoc Co-authored-by: Liam Thompson <[email protected]> --------- Co-authored-by: Liam Thompson <[email protected]> (cherry picked from commit 1e608dc)
leemthompo · Jan 10, 2025 · 91da577 · 91da577
1 parent 1b2772e
commit 91da577
Show file tree

Hide file tree

Showing 2 changed files with 110 additions and 105 deletions.
diff --git a/docs/reference/scripting/using.asciidoc b/docs/reference/scripting/using.asciidoc
@@ -201,8 +201,13 @@ when you're creating <<runtime-mapping-fields,runtime fields>>.
 [[script-stored-scripts]]
 === Store and retrieve scripts
 You can store and retrieve scripts from the cluster state using the
-<<stored-script-apis,stored script APIs>>. Stored scripts reduce compilation
-time and make searches faster.
+<<stored-script-apis,stored script APIs>>. Stored scripts allow you to reference 
+shared scripts for operations like scoring, aggregating, filtering, and 
+reindexing. Instead of embedding scripts inline in each query, you can reference 
+these shared operations.
+
+Stored scripts can also reduce request payload size. Depending on script size 
+and request frequency, this can help lower latency and data transfer costs.
 
 NOTE: Unlike regular scripts, stored scripts require that you specify a script
 language using the `lang` parameter.