Clarify docs

Author: katcharov

driver-core/src/main/com/mongodb/client/model/search/SearchOperator.java

@@ -301,7 +301,7 @@ static GeoNearSearchOperator near(final Point origin, final Number pivot, final
     }
 
     /**
-     * Returns a {@link SearchOperator} that checks whether a field matches a value you specify.
+     * Returns a {@link SearchOperator} that searches for documents where a field matches the specified value.
      *
      * @param path The indexed field to be searched.
      * @param value The boolean value to query for.
@@ -314,7 +314,7 @@ static EqualsSearchOperator equals(final FieldSearchPath path, final boolean val
     }
 
     /**
-     * Returns a {@link SearchOperator} that checks whether a field matches a value you specify.
+     * Returns a {@link SearchOperator} that searches for documents where a field matches the specified value.
      *
      * @param path The indexed field to be searched.
      * @param value The object id value to query for.
@@ -327,7 +327,7 @@ static EqualsSearchOperator equals(final FieldSearchPath path, final ObjectId va
     }
 
     /**
-     * Returns a {@link SearchOperator} that checks whether a field matches a value you specify.
+     * Returns a {@link SearchOperator} that searches for documents where a field matches the specified value.
      *
      * @param path The indexed field to be searched.
      * @param value The number value to query for.
@@ -340,7 +340,7 @@ static EqualsSearchOperator equals(final FieldSearchPath path, final Number valu
     }
 
     /**
-     * Returns a {@link SearchOperator} that checks whether a field matches a value you specify.
+     * Returns a {@link SearchOperator} that searches for documents where a field matches the specified value.
      *
      * @param path The indexed field to be searched.
      * @param value The instant date value to query for.
@@ -353,7 +353,7 @@ static EqualsSearchOperator equals(final FieldSearchPath path, final Instant val
     }
 
     /**
-     * Returns a {@link SearchOperator} that checks whether a field matches a value you specify.
+     * Returns a {@link SearchOperator} that searches for documents where a field matches the specified value.
      *
      * @param path The indexed field to be searched.
      * @param value The string value to query for.
@@ -366,7 +366,7 @@ static EqualsSearchOperator equals(final FieldSearchPath path, final String valu
     }
 
     /**
-     * Returns a {@link SearchOperator} that checks whether a field matches a value you specify.
+     * Returns a {@link SearchOperator} that searches for documents where a field matches the specified value.
      *
      * @param path The indexed field to be searched.
      * @param value The uuid value to query for.
@@ -379,7 +379,7 @@ static EqualsSearchOperator equals(final FieldSearchPath path, final UUID value)
     }
 
     /**
-     * Returns a {@link SearchOperator} that checks whether a field matches null.
+     * Returns a {@link SearchOperator} that searches for documents where a field matches null.
      *
      * @param path The indexed field to be searched.
      * @return The requested {@link SearchOperator}.

driver-scala/src/main/scala/org/mongodb/scala/model/search/SearchOperator.scala

@@ -233,7 +233,7 @@ object SearchOperator {
     JSearchOperator.near(origin, pivot, paths.asJava)
 
   /**
-   * Returns a `SearchOperator` that checks whether a field matches a value you specify.
+   * Returns a `SearchOperator` that searches for documents where a field matches the specified value.
    *
    * @param path The indexed field to be searched.
    * @param value The boolean value to query for.
@@ -244,7 +244,7 @@ object SearchOperator {
     JSearchOperator.equals(path, value)
 
   /**
-   * Returns a `SearchOperator` that checks whether a field matches a value you specify.
+   * Returns a `SearchOperator` that searches for documents where a field matches the specified value.
    *
    * @param path The indexed field to be searched.
    * @param value The object id value to query for.
@@ -255,7 +255,7 @@ object SearchOperator {
     JSearchOperator.equals(path, value)
 
   /**
-   * Returns a `SearchOperator` that checks whether a field matches a value you specify.
+   * Returns a `SearchOperator` that searches for documents where a field matches the specified value.
    *
    * @param path The indexed field to be searched.
    * @param value The number value to query for.
@@ -266,7 +266,7 @@ object SearchOperator {
     JSearchOperator.equals(path, value)
 
   /**
-   * Returns a `SearchOperator` that checks whether a field matches a value you specify.
+   * Returns a `SearchOperator` that searches for documents where a field matches the specified value.
    *
    * @param path The indexed field to be searched.
    * @param value The instant date value to query for.
@@ -277,7 +277,7 @@ object SearchOperator {
     JSearchOperator.equals(path, value)
 
   /**
-   * Returns a `SearchOperator` that checks whether a field matches a value you specify.
+   * Returns a `SearchOperator` that searches for documents where a field matches the specified value.
    *
    * @param path The indexed field to be searched.
    * @param value The string value to query for.
@@ -288,7 +288,7 @@ object SearchOperator {
     JSearchOperator.equals(path, value)
 
   /**
-   * Returns a `SearchOperator` that checks whether a field matches a value you specify.
+   * Returns a `SearchOperator` that searches for documents where a field matches the specified value.
    *
    * @param path The indexed field to be searched.
    * @param value The uuid value to query for.
@@ -299,7 +299,7 @@ object SearchOperator {
     JSearchOperator.equals(path, value)
 
   /**
-   * Returns a `SearchOperator` that checks whether a field matches null.
+   * Returns a `SearchOperator` that searches for documents where a field matches null.
    *
    * @param path The indexed field to be searched.
    * @param value The uuid value to query for.