Skip to content

Commit

Permalink
Fix synonyms documentation (elastic#100916)
Browse files Browse the repository at this point in the history
  • Loading branch information
carlosdelest committed Oct 17, 2023
1 parent bb39220 commit d313d80
Show file tree
Hide file tree
Showing 2 changed files with 6 additions and 6 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -138,7 +138,7 @@ To apply synonyms, you will need to include a synonym graph token filter into an
"my_analyzer": {
"type": "custom",
"tokenizer": "standard",
"filter": ["lowercase", "synonym_graph"]
"filter": ["stemmer", "synonym_graph"]
}
}
----
Expand All @@ -150,8 +150,8 @@ To apply synonyms, you will need to include a synonym graph token filter into an
Order is important for your token filters.
Text will be processed first through filters preceding the synonym filter before being processed by the synonym filter.

In the above example, text will be lowercased by the `lowercase` filter before being processed by the `synonyms_filter`.
This means that all the synonyms defined there needs to be in lowercase, or they won't be found by the synonyms filter.
{es} will also use the token filters preceding the synonym filter in a tokenizer chain to parse the entries in a synonym file or synonym set.
In the above example, the synonyms graph token filter is placed after a stemmer. The stemmer will also be applied to the synonym entries.

The synonym rules should not contain words that are removed by a filter that appears later in the chain (like a `stop` filter).
Removing a term from a synonym rule means there will be no matching for it at query time.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -128,7 +128,7 @@ To apply synonyms, you will need to include a synonym token filters into an anal
"my_analyzer": {
"type": "custom",
"tokenizer": "standard",
"filter": ["lowercase", "synonym"]
"filter": ["stemmer", "synonym_graph"]
}
}
----
Expand All @@ -140,8 +140,8 @@ To apply synonyms, you will need to include a synonym token filters into an anal
Order is important for your token filters.
Text will be processed first through filters preceding the synonym filter before being processed by the synonym filter.

In the above example, text will be lowercased by the `lowercase` filter before being processed by the `synonyms_filter`.
This means that all the synonyms defined there needs to be in lowercase, or they won't be found by the synonyms filter.
{es} will also use the token filters preceding the synonym filter in a tokenizer chain to parse the entries in a synonym file or synonym set.
In the above example, the synonyms graph token filter is placed after a stemmer. The stemmer will also be applied to the synonym entries.

The synonym rules should not contain words that are removed by a filter that appears later in the chain (like a `stop` filter).
Removing a term from a synonym rule means there will be no matching for it at query time.
Expand Down

0 comments on commit d313d80

Please sign in to comment.