Added Percentile aggregation tests and Kibana docs (elastic#111050)

- Added Percentile aggregation tests and autogen docs - Added a new "appendix" section to FunctionInfo. Existing Percentile docs had a final, long section with info, and we need this to leep it. We have an "detailedDescription" attribute already, but it's right after the description, and it would make it harder to read the important bits of the function (types, examples...). So I'm not reusing it.
salvatore-campagna · Jul 23, 2024 · 6686c54 · 6686c54
1 parent 3031855
commit 6686c54
Show file tree

Hide file tree

Showing 18 changed files with 427 additions and 76 deletions.
diff --git a/docs/reference/esql/functions/aggregation-functions.asciidoc b/docs/reference/esql/functions/aggregation-functions.asciidoc
@@ -15,7 +15,7 @@ The <<esql-stats-by>> command supports these aggregate functions:
 * <<esql-agg-median>>
 * <<esql-agg-median-absolute-deviation>>
 * <<esql-min>>
-* <<esql-agg-percentile>>
+* <<esql-percentile>>
 * experimental:[] <<esql-agg-st-centroid>>
 * <<esql-agg-sum>>
 * <<esql-top>>
@@ -27,12 +27,12 @@ include::count.asciidoc[]
 include::count-distinct.asciidoc[]
 include::median.asciidoc[]
 include::median-absolute-deviation.asciidoc[]
-include::percentile.asciidoc[]
 include::st_centroid_agg.asciidoc[]
 include::sum.asciidoc[]
 include::layout/avg.asciidoc[]
 include::layout/max.asciidoc[]
 include::layout/min.asciidoc[]
+include::layout/percentile.asciidoc[]
 include::layout/top.asciidoc[]
 include::values.asciidoc[]
 include::weighted-avg.asciidoc[]
diff --git a/docs/reference/esql/functions/appendix/percentile.asciidoc b/docs/reference/esql/functions/appendix/percentile.asciidoc
diff --git a/docs/reference/esql/functions/description/percentile.asciidoc b/docs/reference/esql/functions/description/percentile.asciidoc
diff --git a/docs/reference/esql/functions/examples/percentile.asciidoc b/docs/reference/esql/functions/examples/percentile.asciidoc
diff --git a/docs/reference/esql/functions/kibana/definition/percentile.json b/docs/reference/esql/functions/kibana/definition/percentile.json
diff --git a/docs/reference/esql/functions/kibana/docs/percentile.md b/docs/reference/esql/functions/kibana/docs/percentile.md
diff --git a/docs/reference/esql/functions/layout/percentile.asciidoc b/docs/reference/esql/functions/layout/percentile.asciidoc
diff --git a/docs/reference/esql/functions/median-absolute-deviation.asciidoc b/docs/reference/esql/functions/median-absolute-deviation.asciidoc
@@ -25,8 +25,8 @@ It is calculated as the median of each data point's deviation from the median of
 the entire sample. That is, for a random variable `X`, the median absolute
 deviation is `median(|median(X) - X|)`.
 
-NOTE: Like <<esql-agg-percentile>>, `MEDIAN_ABSOLUTE_DEVIATION` is
-      <<esql-agg-percentile-approximate,usually approximate>>.
+NOTE: Like <<esql-percentile>>, `MEDIAN_ABSOLUTE_DEVIATION` is
+      <<esql-percentile-approximate,usually approximate>>.
 
 [WARNING]
 ====

diff --git a/docs/reference/esql/functions/median.asciidoc b/docs/reference/esql/functions/median.asciidoc
@@ -17,9 +17,9 @@ Expression from which to return the median value.
 *Description*
 
 Returns the value that is greater than half of all values and less than half of
-all values, also known as the 50% <<esql-agg-percentile>>.
+all values, also known as the 50% <<esql-percentile>>.
 
-NOTE: Like <<esql-agg-percentile>>, `MEDIAN` is <<esql-agg-percentile-approximate,usually approximate>>.
+NOTE: Like <<esql-percentile>>, `MEDIAN` is <<esql-percentile-approximate,usually approximate>>.
 
 [WARNING]
 ====

diff --git a/docs/reference/esql/functions/parameters/percentile.asciidoc b/docs/reference/esql/functions/parameters/percentile.asciidoc
diff --git a/docs/reference/esql/functions/percentile.asciidoc b/docs/reference/esql/functions/percentile.asciidoc
diff --git a/docs/reference/esql/functions/signature/percentile.svg b/docs/reference/esql/functions/signature/percentile.svg
diff --git a/docs/reference/esql/functions/types/percentile.asciidoc b/docs/reference/esql/functions/types/percentile.asciidoc