From 3353597f955d56d71ad9b23a5f5ca72a5a55bb4a Mon Sep 17 00:00:00 2001
From: James Rodewig <40268737+jrodewig@users.noreply.github.com>
Date: Thu, 16 Sep 2021 13:25:09 -0400
Subject: [PATCH] [DOCS] Add deprecation docs for translog retention settings
 (#77814) (#77912)

We deprecated the translog retention settings in 7.7 with PR #45473.
However, we didn't add a related item to the 7.7 breaking changes docs. This adds
the missing item.

Relates to #51697.
---
 docs/reference/migration/migrate_7_7.asciidoc | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/docs/reference/migration/migrate_7_7.asciidoc b/docs/reference/migration/migrate_7_7.asciidoc
index 33d18eaf4d348..14301a643ba18 100644
--- a/docs/reference/migration/migrate_7_7.asciidoc
+++ b/docs/reference/migration/migrate_7_7.asciidoc
@@ -13,6 +13,19 @@ See also <<release-highlights>> and <<es-release-notes>>.
 //Installation and Upgrade Guide
 
 //tag::notable-breaking-changes[]
+[discrete]
+[[breaking_77_indices_deprecations]]
+=== Indices deprecations
+
+[discrete]
+==== Translog retention settings are deprecated.
+
+The `index.translog.retention.age` and `index.translog.retention.size` index
+settings are now deprecated. These settings have been ignored since 7.4 in favor
+of {ref}/index-modules-history-retention.html[soft deletes].
+
+To avoid deprecation warnings, discontinue use of the settings.
+
 [discrete]
 [[breaking_77_logging_changes]]
 === Logging changes