fixed info, test fixes

Author: tteofili

docs/reference/query-languages/esql/_snippets/functions/appendix/values.md

@@ -30,6 +30,10 @@
 import java.io.IOException;
 import java.util.List;
 
+/**
+ * A function to be used to score specific portions of an ES|QL query e.g., in conjunction with
+ * an {@link org.elasticsearch.xpack.esql.plan.logical.Eval}.
+ */
 public class ScoreFunction extends Function implements EvaluatorMapper {
 
     public static final NamedWriteableRegistry.Entry ENTRY = new NamedWriteableRegistry.Entry(
@@ -44,7 +48,7 @@ public class ScoreFunction extends Function implements EvaluatorMapper {
         returnType = "double",
         preview = true,
         description = "Scores a full text function. Returns scores for all the matching docs.",
-        examples = { @Example(file = "score-function", tag = "score-with-field") }
+        examples = { @Example(file = "score-function", tag = "score-single") }
     )
     public ScoreFunction(
         Source source,
@@ -69,7 +73,7 @@ public Expression replaceChildren(List<Expression> newChildren) {
 
     @Override
     protected NodeInfo<? extends Expression> info() {
-        return NodeInfo.create(this, ScoreFunction::new, children());
+        return NodeInfo.create(this, ScoreFunction::new, children().getFirst());
     }
 
     @Override
@@ -79,11 +83,8 @@ public String getWriteableName() {
 
     @Override
     public EvalOperator.ExpressionEvaluator.Factory toEvaluator(EvaluatorMapper.ToEvaluator toEvaluator) {
-
         ScoreOperator.ExpressionScorer.Factory scorerFactory = ScoreMapper.toScorer(children().getFirst(), toEvaluator.shardContexts());
-
         return driverContext -> new ScorerEvaluatorFactory(scorerFactory).get(driverContext);
-
     }
 
     @Override

docs/reference/query-languages/esql/kibana/definition/functions/values.json

@@ -1369,12 +1369,18 @@ public void testKqlFunctionsNotAllowedAfterCommands() throws Exception {
     }
 
     public void testQueryStringFunctionOnlyAllowedInWhere() throws Exception {
-        assertEquals("1:9: [QSTR] function is only supported in WHERE and STATS commands, or in EVAL within score(.) function", error("row a = qstr(\"Anna\")"));
+        assertEquals(
+            "1:9: [QSTR] function is only supported in WHERE and STATS commands, or in EVAL within score(.) function",
+            error("row a = qstr(\"Anna\")")
+        );
         checkFullTextFunctionsOnlyAllowedInWhere("QSTR", "qstr(\"Anna\")", "function");
     }
 
     public void testKqlFunctionOnlyAllowedInWhere() throws Exception {
-        assertEquals("1:9: [KQL] function is only supported in WHERE and STATS commands, or in EVAL within score(.) function", error("row a = kql(\"Anna\")"));
+        assertEquals(
+            "1:9: [KQL] function is only supported in WHERE and STATS commands, or in EVAL within score(.) function",
+            error("row a = kql(\"Anna\")")
+        );
         checkFullTextFunctionsOnlyAllowedInWhere("KQL", "kql(\"Anna\")", "function");
     }
 
@@ -1394,11 +1400,19 @@ public void testMatchOperatornOnlyAllowedInWhere() throws Exception {
     private void checkFullTextFunctionsOnlyAllowedInWhere(String functionName, String functionInvocation, String functionType)
         throws Exception {
         assertEquals(
-            "1:22: [" + functionName + "] " + functionType + " is only supported in WHERE and STATS commands, or in EVAL within score(.) function",
+            "1:22: ["
+                + functionName
+                + "] "
+                + functionType
+                + " is only supported in WHERE and STATS commands, or in EVAL within score(.) function",
             error("from test | eval y = " + functionInvocation)
         );
         assertEquals(
-            "1:18: [" + functionName + "] " + functionType + " is only supported in WHERE and STATS commands, or in EVAL within score(.) function",
+            "1:18: ["
+                + functionName
+                + "] "
+                + functionType
+                + " is only supported in WHERE and STATS commands, or in EVAL within score(.) function",
             error("from test | sort " + functionInvocation + " asc")
         );
         assertEquals(