Remove first and last functions from documentation (#137341)

kkrik-es · leemthompo · web-flow · commit 663f24bfde6d · 2025-10-29T21:59:41.000+02:00
* Remove `first` and `last` functions from documentation

* Apply suggestions from code review

Co-authored-by: Liam Thompson &lt;leemthompo@gmail.com&gt;

* update

---------

Co-authored-by: Liam Thompson &lt;leemthompo@gmail.com&gt;
diff --git a/docs/reference/query-languages/esql/_snippets/functions/layout/first.md b/docs/reference/query-languages/esql/_snippets/functions/layout/first.md
diff --git a/docs/reference/query-languages/esql/_snippets/functions/layout/last.md b/docs/reference/query-languages/esql/_snippets/functions/layout/last.md
diff --git a/docs/reference/query-languages/esql/_snippets/lists/aggregation-functions.md b/docs/reference/query-languages/esql/_snippets/lists/aggregation-functions.md
@@ -2,8 +2,6 @@
 * [`AVG`](../../functions-operators/aggregation-functions.md#esql-avg)
 * [`COUNT`](../../functions-operators/aggregation-functions.md#esql-count)
 * [`COUNT_DISTINCT`](../../functions-operators/aggregation-functions.md#esql-count_distinct)
-* [`FIRST`](../../functions-operators/aggregation-functions.md#esql-first) {applies_to}`stack: ga 9.2`
-* [`LAST`](../../functions-operators/aggregation-functions.md#esql-last) {applies_to}`stack: ga 9.2`
 * [`MAX`](../../functions-operators/aggregation-functions.md#esql-max)
 * [`MEDIAN`](../../functions-operators/aggregation-functions.md#esql-median)
 * [`MEDIAN_ABSOLUTE_DEVIATION`](../../functions-operators/aggregation-functions.md#esql-median_absolute_deviation)
diff --git a/docs/reference/query-languages/esql/functions-operators/aggregation-functions.md b/docs/reference/query-languages/esql/functions-operators/aggregation-functions.md
@@ -28,12 +28,6 @@ The [`STATS`](/reference/query-languages/esql/commands/stats-by.md) and [`INLINE
 :::{include} ../_snippets/functions/layout/count_distinct.md
 :::
 
-:::{include} ../_snippets/functions/layout/first.md
-:::
-
-:::{include} ../_snippets/functions/layout/last.md
-:::
-
 :::{include} ../_snippets/functions/layout/max.md
 :::
 
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/First.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/First.java
@@ -47,7 +47,7 @@ public class First extends AggregateFunction implements ToAggregator {
         type = FunctionType.AGGREGATE,
         returnType = { "long", "integer", "double", "keyword" },
         description = "Calculates the earliest value of a field.",
-        appliesTo = { @FunctionAppliesTo(lifeCycle = FunctionAppliesToLifecycle.GA, version = "9.2.0") },
+        appliesTo = { @FunctionAppliesTo(lifeCycle = FunctionAppliesToLifecycle.GA, version = "9.3.0") },
         examples = @Example(file = "stats_first", tag = "first")
     )
     public First(
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/Last.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/Last.java
@@ -47,7 +47,7 @@ public class Last extends AggregateFunction implements ToAggregator {
         type = FunctionType.AGGREGATE,
         returnType = { "long", "integer", "double", "keyword" },
         description = "Calculates the latest value of a field.",
-        appliesTo = { @FunctionAppliesTo(lifeCycle = FunctionAppliesToLifecycle.GA, version = "9.2.0") },
+        appliesTo = { @FunctionAppliesTo(lifeCycle = FunctionAppliesToLifecycle.GA, version = "9.3.0") },
         examples = @Example(file = "stats_last", tag = "last")
     )
     public Last(

Original file line number	Diff line number	Diff line change
`@@ -47,7 +47,7 @@ public class First extends AggregateFunction implements ToAggregator {`
`47`	`47`	`type = FunctionType.AGGREGATE,`
`48`	`48`	`returnType = { "long", "integer", "double", "keyword" },`
`49`	`49`	`description = "Calculates the earliest value of a field.",`
`50`		`- appliesTo = { @FunctionAppliesTo(lifeCycle = FunctionAppliesToLifecycle.GA, version = "9.2.0") },`
	`50`	`+ appliesTo = { @FunctionAppliesTo(lifeCycle = FunctionAppliesToLifecycle.GA, version = "9.3.0") },`
`51`	`51`	`examples = @Example(file = "stats_first", tag = "first")`
`52`	`52`	`)`
`53`	`53`	`public First(`
Original file line number	Diff line number	Diff line change
`@@ -47,7 +47,7 @@ public class Last extends AggregateFunction implements ToAggregator {`
`47`	`47`	`type = FunctionType.AGGREGATE,`
`48`	`48`	`returnType = { "long", "integer", "double", "keyword" },`
`49`	`49`	`description = "Calculates the latest value of a field.",`
`50`		`- appliesTo = { @FunctionAppliesTo(lifeCycle = FunctionAppliesToLifecycle.GA, version = "9.2.0") },`
	`50`	`+ appliesTo = { @FunctionAppliesTo(lifeCycle = FunctionAppliesToLifecycle.GA, version = "9.3.0") },`
`51`	`51`	`examples = @Example(file = "stats_last", tag = "last")`
`52`	`52`	`)`
`53`	`53`	`public Last(`