From e3599fded7887c2028bddbbc704c776febdd6119 Mon Sep 17 00:00:00 2001 From: Gordon Brown Date: Wed, 7 Aug 2019 14:11:05 -0600 Subject: [PATCH] Add warning about versions to Deprecation API docs (#36624) Add a note that the Deprecation API may not be up to date with all breaking changes until the last minor version in a major version series. --- docs/reference/migration/apis/deprecation.asciidoc | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/reference/migration/apis/deprecation.asciidoc b/docs/reference/migration/apis/deprecation.asciidoc index dafb54e4db8..da10b2f003a 100644 --- a/docs/reference/migration/apis/deprecation.asciidoc +++ b/docs/reference/migration/apis/deprecation.asciidoc @@ -6,6 +6,11 @@ Deprecation info ++++ +IMPORTANT: Use this API to check for deprecated configuration before performing +a major version upgrade. You should run it on the the last minor version of the +major version you are upgrading from, as earlier minor versions may not include +all deprecations. + The deprecation API is to be used to retrieve information about different cluster, node, and index level settings that use deprecated features that will be removed or changed in the next major version.