From 474f63ebacb70742722170f9bb4c75b47ca517f9 Mon Sep 17 00:00:00 2001 From: Clinton Gormley Date: Wed, 9 Nov 2016 15:20:15 +0100 Subject: [PATCH] Added note to ICU docs about the possible need to reindex (#21426) when upgrading from a previous major version. Relates #21352 --- docs/plugins/analysis-icu.asciidoc | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs/plugins/analysis-icu.asciidoc b/docs/plugins/analysis-icu.asciidoc index 1a0f4b5e920..e2d65c95688 100644 --- a/docs/plugins/analysis-icu.asciidoc +++ b/docs/plugins/analysis-icu.asciidoc @@ -7,6 +7,23 @@ libraries, including better analysis of Asian languages, Unicode normalization, Unicode-aware case folding, collation support, and transliteration. +[IMPORTANT] +.ICU analysis and backwards compatibility +================================================ + +From time to time, the ICU library receives updates such as adding new +characters and emojis, and improving collation (sort) orders. These changes +may or may not affect search and sort orders, depending on which characters +sets you are using. + +While we restrict ICU upgrades to major versions, you may find that an index +created in the previous major version will need to be reindexed in order to +return correct (and correctly ordered) results, and to take advantage of new +characters. + +================================================ + + [[analysis-icu-install]] [float] ==== Installation