Browse Source

Update rescoring docs in respect to sort (#20477)

* Update rescoring docs in respect to sort

If sort is present in a query the rescore query is not executed. As long as this feature is neither implemented (see discussion in #6788) nor  the combination of sort and rescoring raises an error, we should warn the user in the documentation about this.

* Missed a dot
Tobias Günther 9 years ago
parent
commit
3a7a437594
1 changed files with 3 additions and 1 deletions
  1. 3 1
      docs/reference/search/request/rescore.asciidoc

+ 3 - 1
docs/reference/search/request/rescore.asciidoc

@@ -12,9 +12,11 @@ A `rescore` request is executed on each shard before it returns its
 results to be sorted by the node handling the overall search request.
 results to be sorted by the node handling the overall search request.
 
 
 Currently the rescore API has only one implementation: the query
 Currently the rescore API has only one implementation: the query
-rescorer, which uses a query to tweak the scoring. In the future, 
+rescorer, which uses a query to tweak the scoring. In the future,
 alternative rescorers may be made available, for example, a pair-wise rescorer.
 alternative rescorers may be made available, for example, a pair-wise rescorer.
 
 
+NOTE: the `rescore` phase is not executed when <<search-request-sort,`sort`>> is used.
+
 NOTE: when exposing pagination to your users, you should not change
 NOTE: when exposing pagination to your users, you should not change
 `window_size` as you step through each page (by passing different
 `window_size` as you step through each page (by passing different
 `from` values) since that can alter the top hits causing results to
 `from` values) since that can alter the top hits causing results to