Address code review comments

Author: julian-elastic

server/src/main/java/org/elasticsearch/index/query/WildcardQueryBuilder.java

@@ -56,7 +56,11 @@ public class WildcardQueryBuilder extends AbstractQueryBuilder<WildcardQueryBuil
     private static final ParseField CASE_INSENSITIVE_FIELD = new ParseField("case_insensitive");
     private boolean caseInsensitive = DEFAULT_CASE_INSENSITIVITY;
 
-    // forces a string like match instead of a wildcard match
+    /**
+     * Force string matching instead of the field-type-aware wildcard matching.
+     * When this is true the {@link org.elasticsearch.index.mapper.IndexFieldMapper} will always match of the
+     * {@code cluster_name:index_name} instead of emulating the glob pattern on the URL.
+     */
     private boolean forceStringMatch = false;
 
     /**
@@ -81,9 +85,14 @@ public WildcardQueryBuilder(String fieldName, String value) {
         this.value = value;
     }
 
-    public WildcardQueryBuilder(String fieldName, String value, boolean isForESQL) {
+    /**
+     * @param forceStringMatch Force string matching instead of the field-type-aware wildcard matching.
+     * When this is true the {@link org.elasticsearch.index.mapper.IndexFieldMapper} will always match of the
+     * {@code cluster_name:index_name} instead of emulating the glob pattern on the URL.
+     */
+    public WildcardQueryBuilder(String fieldName, String value, boolean forceStringMatch) {
         this(fieldName, value);
-        this.forceStringMatch = isForESQL;
+        this.forceStringMatch = forceStringMatch;
     }
 
     /**

x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/io/stream/ExpressionQueryBuilder.java

@@ -30,7 +30,7 @@
 
 /**
  * Implements an Expression query builder, which matches documents based on a given expression.
- * The expression itself must provide the asLuceneQuery and getLuceneQueryDescription methods
+ * The expression itself must provide the {@link TranslationAware#asLuceneQuery} interface to be translated into a Lucene query.
  * It allows for serialization of the expression and generate an AutomatonQuery on the data node
  * as Automaton does not support serialization.
  */
@@ -94,7 +94,7 @@ protected void doXContent(XContentBuilder builder, Params params) throws IOExcep
     }
 
     @Override
-    protected Query doToQuery(SearchExecutionContext context) throws IOException {
+    protected Query doToQuery(SearchExecutionContext context) {
         if (expression instanceof TranslationAware translationAware) {
             MappedFieldType fieldType = context.getFieldType(fieldName);
             if (fieldType == null) {