You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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]>
Copy file name to clipboardExpand all lines: docs/reference/elasticsearch/rest-apis/retrievers/linear-retriever.md
+2-6Lines changed: 2 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -36,11 +36,8 @@ Combining `query` and `retrievers` is not supported.
36
36
Required when `query` is specified.
37
37
38
38
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.
40
39
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`
44
41
45
42
::::{warning}
46
43
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:
83
80
84
81
Specifies how the retriever's score will be normalized before applying the specified `weight`.
85
82
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).
88
84
89
85
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.
0 commit comments