docs: simplify ObjectListFilter overview

Co-authored-by: xperiandri <2365592+xperiandri@users.noreply.github.com>

Author: Copilot

README.md

@@ -405,22 +405,23 @@ type FieldFilter<'Val> =
       Value : 'Val }
 
 type ObjectListFilter =
-    | And of ObjectListFilter * ObjectListFilter
-    | Or of ObjectListFilter * ObjectListFilter
-    | Not of ObjectListFilter
-    | Equals of FieldFilter<System.IComparable> * System.Collections.IComparer
-    | GreaterThan of FieldFilter<System.IComparable>
-    | GreaterThanOrEqual of FieldFilter<System.IComparable>
-    | LessThan of FieldFilter<System.IComparable>
-    | LessThanOrEqual of FieldFilter<System.IComparable>
-    | In of FieldFilter<obj list>
-    | StartsWith of FieldFilter<string> * StringComparer
-    | EndsWith of FieldFilter<string> * StringComparer
-    | Contains of FieldFilter<System.IComparable> * System.Collections.IComparer
-    | OfTypes of Type list
-    | FilterField of FieldFilter<ObjectListFilter>
+    | And of ...
+    | Or of ...
+    | Not of ...
+    | Equals of ...
+    | GreaterThan of ...
+    | GreaterThanOrEqual of ...
+    | LessThan of ...
+    | LessThanOrEqual of ...
+    | In of ...
+    | StartsWith of ...
+    | EndsWith of ...
+    | Contains of ...
+    | OfTypes of ...
+    | FilterField of ...
 ```
 
+- `Equals`, `StartsWith`, `EndsWith`, and `Contains` now carry a comparer in the public DU.
 - `Equals` and `Contains` keep the non-generic `System.Collections.IComparer` because they also support non-string comparable values in the public DU.
 - When the filtered field is a string and you construct the DU cases directly, pass a `StringComparer` instance in that comparer slot: `StringComparer.Ordinal` for case-sensitive matching and `StringComparer.OrdinalIgnoreCase` for case-insensitive matching.
 - The built-in case-sensitive operators (`===`, `=@@`, `@@=`, `@=@`) still use the default comparer behavior for you.

src/FSharp.Data.GraphQL.Server.Middleware/SchemaDefinitions.fs

@@ -184,7 +184,7 @@ let ObjectListFilterType : InputCustomDefinition<ObjectListFilter> = {
             (String.concat
                 " "
                 [
-                    "The `ObjectListFilter` input represents field filters for object lists."
+                    "The `ObjectListFilter` value represents field filters for object lists."
                     "Lowercase string suffixes such as `_starts_with`/`_sw`, `_ends_with`/`_ew`, `_contains`, and `_equals`/`_eq` are case-insensitive when applied to string fields."
                     "Capitalized string suffixes such as `_Starts_With`/`_SW`, `_Ends_With`/`_EW`, `_Contains`, and `_Equals`/`_EQ` are case-sensitive when applied to string fields."
                     "Comparison suffixes such as `_gt`, `_gte`, `_lt`, `_lte`, and `_in` are also supported."