浏览代码

Added note to ICU docs about the possible need to reindex (#21426)

when upgrading from a previous major version.

Relates #21352
Clinton Gormley 9 年之前
父节点
当前提交
474f63ebac
共有 1 个文件被更改,包括 17 次插入0 次删除
  1. 17 0
      docs/plugins/analysis-icu.asciidoc

+ 17 - 0
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