Document restrictions on fuzzy matching when using synonyms (#40783)

Relates to #25518
2019-04-04 09:07:42 +01:00 · 2019-04-04 09:07:42 +01:00 · 8ca7325f65
parent f5f5c3e429
commit 8ca7325f65
1 changed files with 4 additions and 0 deletions
--- a/docs/reference/query-dsl/match-query.asciidoc
+++ b/docs/reference/query-dsl/match-query.asciidoc
@ -56,6 +56,10 @@ rewritten.
 Fuzzy transpositions (`ab` -> `ba`) are allowed by default but can be disabled
 by setting `fuzzy_transpositions` to `false`.

+Note that fuzzy matching is not applied to terms with synonyms, as under the hood
+these terms are expanded to a special synonym query that blends term frequencies,
+which does not support fuzzy expansion.
+
 Here is an example when providing additional parameters (note the slight
 change in structure, `message` is the field name):