Added release highlights to ESQL (elastic#100191)

* Added release highlights to ESQL The original PR was labeled `release highlight` but did not yet have the highlight text. This PR adds a first draft of that text, extracted from the ESQL blog. * Add new screenshot for kibana ESQL * Remove ESQL prefix from all ESQL changelog entries Unlike the original PR's these entries are sorted under an `ES|QL` subsection, so this is redundant, and visually jarring.
gmarouli · Oct 5, 2023 · fc84f70 · fc84f70
1 parent 4d2e442
commit fc84f70
Show file tree

Hide file tree

Showing 31 changed files with 58 additions and 30 deletions.
diff --git a/docs/changelog/100199.yaml b/docs/changelog/100199.yaml
@@ -1,5 +1,5 @@
 pr: 100199
-summary: "ESQL: Simple check if all blocks get released"
+summary: "Simple check if all blocks get released"
 area: ES|QL
 type: enhancement
 issues: []
diff --git a/docs/changelog/94607.yaml b/docs/changelog/94607.yaml
@@ -15,4 +15,4 @@ highlight:
     changed, from picking the shard that uses the most RAM to going over shards in a round-robin
     fashion. This approach has proved to work significantly better in practice.
 
-  notable: true
+  notable: false
diff --git a/docs/changelog/98309.yaml b/docs/changelog/98309.yaml
@@ -1,5 +1,33 @@
 pr: 98309
 summary: "Integrate Elasticsearch Query Language, ES|QL"
-area: Query Languages
+area: ES|QL
 type: feature
 issues: []
+highlight:
+  title: Introducing ES|QL — A new query language for flexible, iterative analytics
+  body: |-
+    As the Elastic Platform has become more widely adopted for search, security, observability, and general analytics,
+    analyst users require the ability to take data-as-ingested, transform it to fit their investigative needs
+    post-ingestion, and derive insights from underlying Elasticsearch index data. They need a concise, integrated,
+    and efficient workflow enabled by rich and expressive queries where search, filter, aggregation,
+    and transformation are performed via a single query expression with little-to-no UI context switching.
+
+    To solve these challenges, the Elastic team is developing the <<esql,Elasticsearch Query Language (ES|QL)>>.
+    ES|QL provides Elastic users with a flexible, powerful, and robust query expression language to interrogate data.
+    ES|QL also provides a superior query UX with post-ingest processing capabilities that fundamentally transforms
+    and expands the analytics and data processing capabilities of Elasticsearch.
+
+    ES|QL introduces distributed compute capabilities to users in disparate roles and with varying skill levels.
+    These compute capabilities enable ES|QL to simplify user workflows in several key ways.
+
+    * Utilize a superior query UX: ES|QL query expressions support complex analytics and data processing.
+      They are easy to learn, read, and share.
+    * Use the filter, aggregation, and transformation capabilities of Elasticsearch with subqueries and lookups,
+      made possible by new Elasticsearch compute and data processing capabilities.
+    * Use ES|QL across Kibana in Discover, Kibana Lens, and Elastic Solutions, giving you seamless workflows.
+      You will be able to visualize ES|QL queries, share them with teams on dashboards or as queries,
+      and use queries to create custom alerts.
+
+    [role="screenshot"]
+    image:images/esql/esql_kibana_discover_logs.png[ES|QL usage in Kibana Discover for Analysing Proxy Logs]
+  notable: true
diff --git a/docs/changelog/98528.yaml b/docs/changelog/98528.yaml
@@ -1,5 +1,5 @@
 pr: 98528
-summary: "ESQL: Add support for TEXT fields in comparison operators and SORT"
+summary: "Add support for TEXT fields in comparison operators and SORT"
 area: ES|QL
 type: enhancement
 issues:

diff --git a/docs/changelog/98590.yaml b/docs/changelog/98590.yaml
@@ -1,5 +1,5 @@
 pr: 98590
-summary: "ESQL: LTRIM, RTRIM and fix unicode whitespace"
+summary: "LTRIM, RTRIM and fix unicode whitespace"
 area: ES|QL
 type: feature
 issues: []
diff --git a/docs/changelog/98630.yaml b/docs/changelog/98630.yaml
@@ -1,5 +1,5 @@
 pr: 98630
-summary: "ESQL: LEAST and GREATEST functions"
+summary: "LEAST and GREATEST functions"
 area: ES|QL
 type: feature
 issues: []
diff --git a/docs/changelog/98759.yaml b/docs/changelog/98759.yaml
@@ -1,5 +1,5 @@
 pr: 98759
-summary: "ESQL: Support queries that don't return underlying fields"
+summary: "Support queries that don't return underlying fields"
 area: ES|QL
 type: bug
 issues:

diff --git a/docs/changelog/98847.yaml b/docs/changelog/98847.yaml
@@ -1,5 +1,5 @@
 pr: 98847
-summary: "ESQL: Add `CEIL` function"
+summary: "Add `CEIL` function"
 area: ES|QL
 type: enhancement
 issues: []
diff --git a/docs/changelog/98870.yaml b/docs/changelog/98870.yaml
@@ -1,5 +1,5 @@
 pr: 98870
-summary: "ESQL: Add ability to perform date math"
+summary: "Add ability to perform date math"
 area: ES|QL
 type: enhancement
 issues:

diff --git a/docs/changelog/98942.yaml b/docs/changelog/98942.yaml
@@ -1,5 +1,5 @@
 pr: 98942
-summary: "ESQL: LEFT function"
+summary: "LEFT function"
 area: ES|QL
 type: feature
 issues: []
diff --git a/docs/changelog/98972.yaml b/docs/changelog/98972.yaml
@@ -1,5 +1,5 @@
 pr: 98972
-summary: "ES|QL: Implement serialization of `InvalidMappedField`"
+summary: "Implement serialization of `InvalidMappedField`"
 area: ES|QL
 type: bug
 issues:

diff --git a/docs/changelog/98974.yaml b/docs/changelog/98974.yaml
@@ -1,5 +1,5 @@
 pr: 98974
-summary: "ESQL: RIGHT function"
+summary: "RIGHT function"
 area: ES|QL
 type: feature
 issues: []
diff --git a/docs/changelog/99054.yaml b/docs/changelog/99054.yaml
@@ -1,5 +1,5 @@
 pr: 99054
-summary: "ESQL: Mark counter fields as unsupported"
+summary: "Mark counter fields as unsupported"
 area: ES|QL
 type: enhancement
 issues: []
diff --git a/docs/changelog/99058.yaml b/docs/changelog/99058.yaml
@@ -1,5 +1,5 @@
 pr: 99058
-summary: "ESQL: log query and execution time"
+summary: "Log query and execution time"
 area: ES|QL
 type: enhancement
 issues: []
diff --git a/docs/changelog/99188.yaml b/docs/changelog/99188.yaml
@@ -1,5 +1,5 @@
 pr: 99188
-summary: "ESQL: skip synthetic attributes when planning the physical fragment"
+summary: "Skip synthetic attributes when planning the physical fragment"
 area: ES|QL
 type: bug
 issues:

diff --git a/docs/changelog/99286.yaml b/docs/changelog/99286.yaml
@@ -1,5 +1,5 @@
 pr: 99286
-summary: "ESQL: Log execution time consistently"
+summary: "Log execution time consistently"
 area: ES|QL
 type: enhancement
 issues: []
diff --git a/docs/changelog/99310.yaml b/docs/changelog/99310.yaml
@@ -1,5 +1,5 @@
 pr: 99310
-summary: "ESQL: \"params\" correctly parses the values including an optional \"type\""
+summary: "\"params\" correctly parses the values including an optional \"type\""
 area: ES|QL
 type: bug
 issues:

diff --git a/docs/changelog/99316.yaml b/docs/changelog/99316.yaml
@@ -1,5 +1,5 @@
 pr: 99316
-summary: "ESQL: Compact topn"
+summary: "Compact topn"
 area: ES|QL
 type: enhancement
 issues: []
diff --git a/docs/changelog/99382.yaml b/docs/changelog/99382.yaml
@@ -1,5 +1,5 @@
 pr: 99382
-summary: "ESQL: create a Vector when needed for IN"
+summary: "Create a Vector when needed for IN"
 area: ES|QL
 type: bug
 issues:

diff --git a/docs/changelog/99432.yaml b/docs/changelog/99432.yaml
@@ -1,5 +1,5 @@
 pr: 99432
-summary: "ESQL: Enable arithmetics for durations and periods"
+summary: "Enable arithmetics for durations and periods"
 area: ES|QL
 type: enhancement
 issues: [99293]
diff --git a/docs/changelog/99470.yaml b/docs/changelog/99470.yaml
@@ -1,5 +1,5 @@
 pr: 99470
-summary: "ESQL: Improve log messages"
+summary: "Improve log messages"
 area: ES|QL
 type: enhancement
 issues: []
diff --git a/docs/changelog/99601.yaml b/docs/changelog/99601.yaml
@@ -1,5 +1,5 @@
 pr: 99601
-summary: "ESQL: continue resolving attributes for Eval"
+summary: "Continue resolving attributes for Eval"
 area: ES|QL
 type: bug
 issues:

diff --git a/docs/changelog/99695.yaml b/docs/changelog/99695.yaml
@@ -1,5 +1,5 @@
 pr: 99695
-summary: "ESQL: Better management of not stored TEXT fiels with synthetic source"
+summary: "Better management of not stored TEXT fiels with synthetic source"
 area: ES|QL
 type: bug
 issues: []
diff --git a/docs/changelog/99711.yaml b/docs/changelog/99711.yaml
@@ -1,5 +1,5 @@
 pr: 99711
-summary: "ESQL: Date math for negatives"
+summary: "Date math for negatives"
 area: ES|QL
 type: enhancement
 issues: []
diff --git a/docs/changelog/99726.yaml b/docs/changelog/99726.yaml
@@ -1,5 +1,5 @@
 pr: 99726
-summary: "ESQL: Account for an exception being thrown when building a `BytesRefArrayBlock`"
+summary: "Account for an exception being thrown when building a `BytesRefArrayBlock`"
 area: ES|QL
 type: bug
 issues:

diff --git a/docs/changelog/99736.yaml b/docs/changelog/99736.yaml
@@ -1,5 +1,5 @@
 pr: 99736
-summary: "ESQL: enhance SHOW FUNCTIONS command"
+summary: "Enhance SHOW FUNCTIONS command"
 area: ES|QL
 type: enhancement
 issues:

diff --git a/docs/changelog/99746.yaml b/docs/changelog/99746.yaml
@@ -1,5 +1,5 @@
 pr: 99746
-summary: "ESQL: Log start and end of queries"
+summary: "Log start and end of queries"
 area: ES|QL
 type: enhancement
 issues: []
diff --git a/docs/changelog/99816.yaml b/docs/changelog/99816.yaml
@@ -1,5 +1,5 @@
 pr: 99816
-summary: "ESQL: Lower the implicit limit, if none is user-provided"
+summary: "Lower the implicit limit, if none is user-provided"
 area: ES|QL
 type: enhancement
 issues:

diff --git a/docs/changelog/99874.yaml b/docs/changelog/99874.yaml
@@ -1,5 +1,5 @@
 pr: 99874
-summary: "ESQL: Use exact attributes for data source extraction"
+summary: "Use exact attributes for data source extraction"
 area: ES|QL
 type: bug
 issues:

diff --git a/docs/changelog/99956.yaml b/docs/changelog/99956.yaml
@@ -1,5 +1,5 @@
 pr: 99956
-summary: "ESQL: Serialize the source in expressions"
+summary: "Serialize the source in expressions"
 area: ES|QL
 type: enhancement
 issues: []
diff --git a/docs/reference/images/esql/esql_kibana_discover_logs.png b/docs/reference/images/esql/esql_kibana_discover_logs.png