Fix docs for scoring examples

carlosdelest · Jan 21, 2025 · a1d3cb3 · a1d3cb3
1 parent b5c94d3
commit a1d3cb3
Showing 1 changed file with 11 additions and 3 deletions.
diff --git a/docs/reference/esql/esql-limitations.asciidoc b/docs/reference/esql/esql-limitations.asciidoc
@@ -134,19 +134,27 @@ FROM books
 | WHERE MATCH(author, "Faulkner")
 ----
 
-And this query will fail due to the disjunction:
+And this query that uses a disjunction will succeed:
 
 [source,esql]
 ----
 FROM books
+| WHERE MATCH(author, "Faulkner") OR QSTR("author: Hemingway")
+----
+
+However using scoring will fail because it uses a non full text function as part of the disjunction:
+
+[source,esql]
+----
+FROM books METADATA _score
 | WHERE MATCH(author, "Faulkner") OR author LIKE "Hemingway"
 ----
 
-However this query will succeed because it uses full text functions on both `OR` clauses:
+Scoring will work in the following query, as it uses full text functions on both `OR` clauses:
 
 [source,esql]
 ----
-FROM books
+FROM books METADATA _score
 | WHERE MATCH(author, "Faulkner") OR QSTR("author: Hemingway")
 ----