Skip to content

Commit b6f5141

Browse files
Improve documentation for Linear Top Level Normalizer (#134216)
* Improved changes to the doc * Add back missing warning about avoiding 'none' normalizer with field grouping * Move applies_to tag to specific behavior description to clarify version support * cleaning it up * cleaned up * cleaned up * Update linear-retriever.md * Update docs/reference/elasticsearch/rest-apis/retrievers/linear-retriever.md Co-authored-by: Liam Thompson <[email protected]> * Update docs/reference/elasticsearch/rest-apis/retrievers/linear-retriever.md Co-authored-by: Liam Thompson <[email protected]> --------- Co-authored-by: Liam Thompson <[email protected]>
1 parent 02cefc7 commit b6f5141

File tree

1 file changed

+2
-6
lines changed

1 file changed

+2
-6
lines changed

docs/reference/elasticsearch/rest-apis/retrievers/linear-retriever.md

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -36,11 +36,8 @@ Combining `query` and `retrievers` is not supported.
3636
Required when `query` is specified.
3737

3838
When used with the [multi-field query format](../retrievers.md#multi-field-query-format) (`query` parameter), normalizes scores per [field grouping](../retrievers.md#multi-field-field-grouping).
39-
Otherwise serves as the default normalizer for any sub-retriever that doesn't specify its own normalizer. Per-retriever normalizers always take precedence over the top-level normalizer.
4039

41-
:::{note}
42-
**Top-level normalizer support for sub-retrievers**: The ability to use a top-level normalizer as a default for sub-retrievers was introduced in Elasticsearch 9.2+. In earlier versions, only per-retriever normalizers are supported.
43-
:::
40+
Otherwise this serves as the default normalizer for any sub-retriever that doesn't specify its own normalizer. Per-retriever normalizers always take precedence over the top-level normalizer. {applies_to}`stack: ga 9.2`
4441

4542
::::{warning}
4643
Avoid using `none` as that will disable normalization and may bias the result set towards lexical matches.
@@ -83,8 +80,7 @@ Each entry in the `retrievers` array specifies the following parameters:
8380

8481
Specifies how the retriever's score will be normalized before applying the specified `weight`.
8582
See [normalizers](#linear-retriever-normalizers) for supported values.
86-
If not specified, uses the top-level `normalizer` or defaults to `none` if no top-level normalizer is set.
87-
{applies_to}`stack: ga 9.2`
83+
If not specified, uses the top-level `normalizer` (9.2+) or defaults to `none` (earlier versions).
8884

8985
See also [this hybrid search example](retrievers-examples.md#retrievers-examples-linear-retriever) using a linear retriever on how to independently configure and apply normalizers to retrievers.
9086

0 commit comments

Comments
 (0)