Correct docs for multi_match scoring (#91430)

jtibshirani · web-flow · commit 509b636d254f · 2022-11-10T08:16:56.000-08:00
The documentation claimed that for the most_fields type, the score is equal to
the sum of all matches divided by the number of matches. This is not correct,
we actually don't divide by the number of matches.

This line in the documentation was added several years ago as part of a large
PR, and was likely just a mistake.
diff --git a/docs/reference/query-dsl/multi-match-query.asciidoc b/docs/reference/query-dsl/multi-match-query.asciidoc
@@ -244,8 +244,7 @@ GET /_search
 }
 --------------------------------------------------
 
-The score from each `match` clause is added together, then divided by the
-number of `match` clauses.
+The score from each `match` clause is added together, just like a `bool` query.
 
 Also, accepts `analyzer`, `boost`, `operator`, `minimum_should_match`,
 `fuzziness`, `lenient`, `prefix_length`, `max_expansions`, `fuzzy_rewrite`, and `zero_terms_query`.

Original file line number	Diff line number	Diff line change
`@@ -244,8 +244,7 @@ GET /_search`
`244`	`244`	`}`
`245`	`245`	`--------------------------------------------------`
`246`	`246`
`247`		-The score from each `match` clause is added together, then divided by the
`248`		-number of `match` clauses.
	`247`	+The score from each `match` clause is added together, just like a `bool` query.
`249`	`248`
`250`	`249`	Also, accepts `analyzer`, `boost`, `operator`, `minimum_should_match`,
`251`	`250`	`fuzziness`, `lenient`, `prefix_length`, `max_expansions`, `fuzzy_rewrite`, and `zero_terms_query`.