From f3f11ab3651fcf81ff776c37ebdab4053eb23085 Mon Sep 17 00:00:00 2001
From: James Rodewig <40268737+jrodewig@users.noreply.github.com>
Date: Mon, 20 Sep 2021 13:16:11 -0400
Subject: [PATCH] [DOCS] Add breaking change for `moving_avg` (#78018)

Documents the removal of the `moving_avg` aggregation in the 8.0 breaking changes.

Relates to #29594.
---
 .../migration/migrate_8_0/aggregations.asciidoc | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/reference/migration/migrate_8_0/aggregations.asciidoc b/docs/reference/migration/migrate_8_0/aggregations.asciidoc
index 2daaac9a27076..b5667ee207a1a 100644
--- a/docs/reference/migration/migrate_8_0/aggregations.asciidoc
+++ b/docs/reference/migration/migrate_8_0/aggregations.asciidoc
@@ -6,6 +6,22 @@
 //Installation and Upgrade Guide
 
 //tag::notable-breaking-changes[]
+
+[[remove-moving-avg-agg]]
+.The `moving_avg` aggregation has been removed.
+[%collapsible]
+====
+*Details* +
+The `moving_avg` aggregation was deprecated in 6.4 and has been removed. To
+calculate moving averages, use the
+{ref}/search-aggregations-pipeline-movfn-aggregation.html[`moving_fn`
+aggregation] instead.
+
+*Impact* +
+Discontinue use of the `moving_avg` aggregation. Requests that include the
+`moving_avg` aggregation will return an error.
+====
+
 [[percentile-duplication]]
 .The `percentiles` aggregation's `percents` parameter no longer supports duplicate values.
 [%collapsible]
@@ -20,6 +36,7 @@ Use unique values in the `percents` parameter of the `percentiles` aggregation.
 Requests containing duplicate values in the `percents` parameter will return
 an error.
 ====
+
 [[date-histogram-interval]]
 .The `date_histogram` aggregation's `interval` parameter is no longer valid.
 [%collapsible]