diff --git a/docs/reference/query-dsl/boosting-query.asciidoc b/docs/reference/query-dsl/boosting-query.asciidoc index 61efa213abf..4f2f60e5e22 100644 --- a/docs/reference/query-dsl/boosting-query.asciidoc +++ b/docs/reference/query-dsl/boosting-query.asciidoc @@ -5,7 +5,7 @@ ++++ Returns documents matching a `positive` query while reducing the -<> of documents that also match a +<> of documents that also match a `negative` query. You can use the `boosting` query to demote certain documents without @@ -47,12 +47,12 @@ match this query. `negative`:: + -- -(Required, query object) Query used to decrease the <> of matching documents. +(Required, query object) Query used to decrease the <> of matching documents. If a returned document matches the `positive` query and this query, the -`boosting` query calculates the final <> -for the document as follows: +`boosting` query calculates the final <> for +the document as follows: . Take the original relevance score from the `positive` query. . Multiply the score by the `negative_boost` value. @@ -60,5 +60,5 @@ for the document as follows: `negative_boost`:: (Required, float) Floating point number between `0` and `1.0` used to decrease -the <> of documents matching the +the <> of documents matching the `negative` query. \ No newline at end of file diff --git a/docs/reference/query-dsl/constant-score-query.asciidoc b/docs/reference/query-dsl/constant-score-query.asciidoc index a20505456de..dd55e38b3b0 100644 --- a/docs/reference/query-dsl/constant-score-query.asciidoc +++ b/docs/reference/query-dsl/constant-score-query.asciidoc @@ -5,7 +5,7 @@ ++++ Wraps a <> and returns every matching -document with a <> equal to the `boost` +document with a <> equal to the `boost` parameter value. [source,js] @@ -32,11 +32,11 @@ GET /_search (Required, query object) <> you wish to run. Any returned documents must match this query. -Filter queries do not calculate <>. To +Filter queries do not calculate <>. To speed up performance, {es} automatically caches frequently used filter queries. -- `boost`:: (Optional, float) Floating point number used as the constant -<> for every document matching the +<> for every document matching the `filter` query. Defaults to `1.0`. \ No newline at end of file diff --git a/docs/reference/query-dsl/dis-max-query.asciidoc b/docs/reference/query-dsl/dis-max-query.asciidoc index 21d596024ee..57c012802d0 100644 --- a/docs/reference/query-dsl/dis-max-query.asciidoc +++ b/docs/reference/query-dsl/dis-max-query.asciidoc @@ -47,7 +47,7 @@ score>>. + -- (Optional, float) Floating point number between `0` and `1.0` used to increase -the <> of documents matching multiple +the <> of documents matching multiple query clauses. Defaults to `0.0`. You can use the `tie_breaker` value to assign higher relevance scores to diff --git a/docs/reference/query-dsl/distance-feature-query.asciidoc b/docs/reference/query-dsl/distance-feature-query.asciidoc index 749609e411c..05543fca80f 100644 --- a/docs/reference/query-dsl/distance-feature-query.asciidoc +++ b/docs/reference/query-dsl/distance-feature-query.asciidoc @@ -4,7 +4,7 @@ Distance feature ++++ -Boosts the <> of documents closer to a +Boosts the <> of documents closer to a provided `origin` date or point. For example, you can use this query to give more weight to documents closer to a certain date or location. @@ -196,7 +196,7 @@ must be a <>, such as `1km` or `12m`. + -- (Optional, float) Floating point number used to multiply the -<> of matching documents. This value +<> of matching documents. This value cannot be negative. Defaults to `1.0`. -- @@ -208,11 +208,11 @@ cannot be negative. Defaults to `1.0`. ===== How the `distance_feature` query calculates relevance scores The `distance_feature` query dynamically calculates the distance between the `origin` value and a document's field values. It then uses this distance as a -feature to boost the <> of closer +feature to boost the <> of closer documents. -The `distance_feature` query calculates a document's <> as follows: +The `distance_feature` query calculates a document's +<> as follows: ``` relevance score = boost * pivot / (pivot + distance) @@ -224,6 +224,6 @@ document's field value. [[distance-feature-skip-hits]] ===== Skip non-competitive hits Unlike the <> query or other -ways to change <>, the +ways to change <>, the `distance_feature` query efficiently skips non-competitive hits when the <> parameter is **not** `true`. \ No newline at end of file diff --git a/docs/reference/query-dsl/has-child-query.asciidoc b/docs/reference/query-dsl/has-child-query.asciidoc index a5e022ed2e3..95805dbd2e6 100644 --- a/docs/reference/query-dsl/has-child-query.asciidoc +++ b/docs/reference/query-dsl/has-child-query.asciidoc @@ -107,7 +107,7 @@ document does not meet this limit, it is excluded from the search results. + -- (Optional, string) Indicates how scores for matching child documents affect the -root parent document's <>. Valid values +root parent document's <>. Valid values are: `none` (Default):: diff --git a/docs/reference/query-dsl/nested-query.asciidoc b/docs/reference/query-dsl/nested-query.asciidoc index a4cd59bd31a..a35d3ed3fac 100644 --- a/docs/reference/query-dsl/nested-query.asciidoc +++ b/docs/reference/query-dsl/nested-query.asciidoc @@ -86,7 +86,7 @@ than root, if it exists within another nested query. + -- (Optional, string) Indicates how scores for matching child objects affect the -root parent document's <>. Valid values +root parent document's <>. Valid values are: `avg` (Default):: diff --git a/docs/reference/query-dsl/range-query.asciidoc b/docs/reference/query-dsl/range-query.asciidoc index a9303fcb9fc..d8518afda57 100644 --- a/docs/reference/query-dsl/range-query.asciidoc +++ b/docs/reference/query-dsl/range-query.asciidoc @@ -122,7 +122,7 @@ convert a value of `now/d`. + -- (Optional, float) Floating point number used to decrease or increase the -<> of a query. Defaults to `1.0`. +<> of a query. Defaults to `1.0`. You can use the `boost` parameter to adjust relevance scores for searches containing two or more queries. diff --git a/docs/reference/query-dsl/term-query.asciidoc b/docs/reference/query-dsl/term-query.asciidoc index d42ced29f26..a80f065dcd7 100644 --- a/docs/reference/query-dsl/term-query.asciidoc +++ b/docs/reference/query-dsl/term-query.asciidoc @@ -54,7 +54,7 @@ capitalization. `boost`:: (Optional, float) Floating point number used to decrease or increase the -<> of a query. Defaults to `1.0`. +<> of a query. Defaults to `1.0`. + You can use the `boost` parameter to adjust relevance scores for searches containing two or more queries. diff --git a/docs/reference/query-dsl/terms-query.asciidoc b/docs/reference/query-dsl/terms-query.asciidoc index ef9a898af2e..71aa11eb125 100644 --- a/docs/reference/query-dsl/terms-query.asciidoc +++ b/docs/reference/query-dsl/terms-query.asciidoc @@ -53,7 +53,7 @@ To use the field values of an existing document as search terms, use the + -- (Optional, float) Floating point number used to decrease or increase the -<> of a query. Defaults to `1.0`. +<> of a query. Defaults to `1.0`. You can use the `boost` parameter to adjust relevance scores for searches containing two or more queries. diff --git a/docs/reference/query-dsl/wildcard-query.asciidoc b/docs/reference/query-dsl/wildcard-query.asciidoc index 7a2aebbed92..95e52352a76 100644 --- a/docs/reference/query-dsl/wildcard-query.asciidoc +++ b/docs/reference/query-dsl/wildcard-query.asciidoc @@ -57,7 +57,7 @@ the iterations needed to find matching terms and slow search performance. `boost`:: (Optional, float) Floating point number used to decrease or increase the -<> of a query. Defaults to `1.0`. +<> of a query. Defaults to `1.0`. + You can use the `boost` parameter to adjust relevance scores for searches containing two or more queries.