diff --git a/docs/reference/search/request/rescore.asciidoc b/docs/reference/search/request/rescore.asciidoc index 204960544a6..6e1bb2a9e6c 100644 --- a/docs/reference/search/request/rescore.asciidoc +++ b/docs/reference/search/request/rescore.asciidoc @@ -15,7 +15,8 @@ Currently the rescore API has only one implementation: the query rescorer, which uses a query to tweak the scoring. In the future, alternative rescorers may be made available, for example, a pair-wise rescorer. -NOTE: the `rescore` phase is not executed when <> is used. +NOTE: An error will be thrown if an explicit <> (other than `_score`) +is provided with a `rescore` query. NOTE: when exposing pagination to your users, you should not change `window_size` as you step through each page (by passing different