Fix some docs issues

Author: carlosdelest

docs/reference/esql/functions/functionNamedParams/match.asciidoc

@@ -591,6 +591,10 @@ public List<String> argNames() {
         public List<String> argDescriptions() {
             return args.stream().map(ArgSignature::description).toList();
         }
+
+        public List<Boolean> argOptionals() {
+            return args.stream().map(ArgSignature::optional).toList();
+        }
     }
 
     /**

docs/reference/esql/functions/kibana/definition/match.json

@@ -182,9 +182,14 @@ public Match(
                     name = "operator",
                     type = "keyword",
                     valueHint = { "AND", "OR" },
-                    description = "Boolean logic used to interpret text in the query value"
+                    description = "Boolean logic used to interpret text in the query value."
+                ),
+                @MapParam.MapParamEntry(
+                    name = "prefix_length",
+                    type = "integer",
+                    valueHint = { "1" },
+                    description = "Number of beginning characters left unchanged for fuzzy matching."
                 ),
-                @MapParam.MapParamEntry(name = "prefix_length", valueHint = { "1" }, description = ""),
                 @MapParam.MapParamEntry(
                     name = "zero_terms_query",
                     type = "keyword",

docs/reference/esql/functions/layout/match.asciidoc

@@ -928,7 +928,7 @@ protected static void renderDocs(String name) throws IOException {
                 );
             }
             renderTypes(name, description.args());
-            renderParametersList(name, description.argNames(), description.argDescriptions());
+            renderParametersList(name, description.argNames(), description.argDescriptions(), description.argOptionals());
             FunctionInfo info = EsqlFunctionRegistry.functionInfo(definition);
             renderDescription(name, description.description(), info.detailedDescription(), info.note());
             Optional<EsqlFunctionRegistry.ArgSignature> mapArgSignature = description.args()
@@ -1007,12 +1007,17 @@ private static void renderTypes(String name, List<EsqlFunctionRegistry.ArgSignat
         writeToTempDir("types", name, "asciidoc", rendered);
     }
 
-    private static void renderParametersList(String name, List<String> argNames, List<String> argDescriptions) throws IOException {
+    private static void renderParametersList(String name, List<String> argNames, List<String> argDescriptions, List<Boolean> argsOptional)
+        throws IOException {
         StringBuilder builder = new StringBuilder();
         builder.append(DOCS_WARNING);
         builder.append("*Parameters*\n");
         for (int a = 0; a < argNames.size(); a++) {
-            builder.append("\n`").append(argNames.get(a)).append("`::\n").append(argDescriptions.get(a)).append('\n');
+            builder.append("\n`").append(argNames.get(a)).append("`::\n");
+            if (argsOptional.get(a)) {
+                builder.append("(Optional) ");
+            }
+            builder.append(argDescriptions.get(a)).append('\n');
         }
         String rendered = builder.toString();
         LogManager.getLogger(getTestClass()).info("Writing parameters for [{}]:\n{}", name, rendered);
@@ -1127,7 +1132,7 @@ private static void renderFullLayout(String name, boolean preview, boolean hasEx
             .replace("$UPPER_NAME$", name.toUpperCase(Locale.ROOT))
             .replace("$PREVIEW_CALLOUT$", preview ? PREVIEW_CALLOUT : "");
         if (hasFunctionOptions) {
-            rendered += "include::../optionalFunctionParams/" + name + ".asciidoc[]\n";
+            rendered += "include::../functionNamedParams/" + name + ".asciidoc[]\n";
         }
         if (hasExamples) {
             rendered += "include::../examples/" + name + ".asciidoc[]\n";