From 77720dc63e0b6cb60b7107e5627f3200b81a70ec Mon Sep 17 00:00:00 2001 From: Luca Cavanna Date: Thu, 6 Jun 2019 16:46:10 +0200 Subject: [PATCH 1/3] [DOCS] Clarify phrase suggester docs smoothing parameter Closes #28512 --- docs/reference/search/suggesters/phrase-suggest.asciidoc | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/reference/search/suggesters/phrase-suggest.asciidoc b/docs/reference/search/suggesters/phrase-suggest.asciidoc index d92c32eddf033..a512bdb94ea60 100644 --- a/docs/reference/search/suggesters/phrase-suggest.asciidoc +++ b/docs/reference/search/suggesters/phrase-suggest.asciidoc @@ -267,7 +267,9 @@ POST _search The `phrase` suggester supports multiple smoothing models to balance weight between infrequent grams (grams (shingles) are not existing in -the index) and frequent grams (appear at least once in the index). +the index) and frequent grams (appear at least once in the index). The +smoothing model can be selected setting the `smoothing` parameter to one +of the following options: [horizontal] `stupid_backoff`:: From 6c67baf2c9fc714e6515c8fa3bd34bc980062f78 Mon Sep 17 00:00:00 2001 From: Luca Cavanna Date: Thu, 6 Jun 2019 17:24:45 +0200 Subject: [PATCH 2/3] add example --- .../search/suggesters/phrase-suggest.asciidoc | 22 +++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/docs/reference/search/suggesters/phrase-suggest.asciidoc b/docs/reference/search/suggesters/phrase-suggest.asciidoc index a512bdb94ea60..6b3f5045e54cd 100644 --- a/docs/reference/search/suggesters/phrase-suggest.asciidoc +++ b/docs/reference/search/suggesters/phrase-suggest.asciidoc @@ -290,6 +290,28 @@ of the following options: All parameters (`trigram_lambda`, `bigram_lambda`, `unigram_lambda`) must be supplied. +[source,js] +-------------------------------------------------- +POST _search +{ + "suggest": { + "text" : "obel prize", + "simple_phrase" : { + "phrase" : { + "field" : "title.trigram", + "size" : 1, + "smoothing" : { + "laplace" : { + "alpha" : 0.7 + } + } + } + } + } +} +-------------------------------------------------- +// CONSOLE + ==== Candidate Generators The `phrase` suggester uses candidate generators to produce a list of From aeba163fe520997fc345bcc80aee389a1908dc94 Mon Sep 17 00:00:00 2001 From: Luca Cavanna Date: Fri, 7 Jun 2019 11:11:44 +0200 Subject: [PATCH 3/3] add small sentence --- docs/reference/search/suggesters/phrase-suggest.asciidoc | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/reference/search/suggesters/phrase-suggest.asciidoc b/docs/reference/search/suggesters/phrase-suggest.asciidoc index 6b3f5045e54cd..bfbfbc5417977 100644 --- a/docs/reference/search/suggesters/phrase-suggest.asciidoc +++ b/docs/reference/search/suggesters/phrase-suggest.asciidoc @@ -268,8 +268,9 @@ POST _search The `phrase` suggester supports multiple smoothing models to balance weight between infrequent grams (grams (shingles) are not existing in the index) and frequent grams (appear at least once in the index). The -smoothing model can be selected setting the `smoothing` parameter to one -of the following options: +smoothing model can be selected by setting the `smoothing` parameter +to one of the following options. Each smoothing model supports specific +properties that can be configured. [horizontal] `stupid_backoff`::