docs: finalize ObjectListFilter clarifications

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

Author: Copilot

README.md

@@ -401,7 +401,7 @@ This filter is mapped by the middleware into the `ObjectListFilter` discriminate
 
 - `Equals`, `StartsWith`, `EndsWith`, and `Contains` now carry a comparer in the public discriminated union.
 - `Equals` and `Contains` keep the non-generic `System.Collections.IComparer` because they also support non-string comparable values in the public discriminated union.
-- 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.
+- When the filtered field is a string and you construct the DU cases directly, pass a `StringComparer` instance in that comparer slot. `StringComparer` is accepted there because it also implements `System.Collections.IComparer`. Use `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.
 - `Contains` is also used for collection membership checks, so the wrapped value type inside `FieldFilter<_>` stays `System.IComparable` instead of being limited to `string`.
 - If you were previously constructing `Equals`, `StartsWith`, `EndsWith`, or `Contains` directly, update those call sites to provide the comparer argument explicitly.

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

@@ -11,8 +11,8 @@ type FieldFilter<'Val> = { FieldName : string; Value : 'Val }
 /// A filter definition for an object list.
 /// </summary>
 /// <remarks>
-/// String-based filters can carry a comparer. When the comparer is omitted internally by the
-/// default case-sensitive operators, that value is handled the same as `StringComparer.Ordinal`.
+/// String-based filters can carry a comparer. When the comparer is not provided by the default
+/// case-sensitive operators, the behavior is equivalent to using `StringComparer.Ordinal`.
 /// `StringComparer.OrdinalIgnoreCase` enables case-insensitive matching.
 /// When filters are provided through GraphQL input, lowercase string suffixes are interpreted
 /// as case-insensitive and capitalized suffixes are interpreted as case-sensitive.

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

@@ -185,8 +185,8 @@ let ObjectListFilterType : InputCustomDefinition<ObjectListFilter> = {
                 " "
                 [
                     "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."
+                    "Lowercase string suffixes such as `_starts_with`/`_sw`, `_ends_with`/`_ew`, `_contains` (no shorthand), and `_equals`/`_eq` are case-insensitive when applied to string fields."
+                    "Capitalized string suffixes such as `_Starts_With`/`_SW`, `_Ends_With`/`_EW`, `_Contains` (no shorthand), and `_Equals`/`_EQ` are case-sensitive when applied to string fields."
                     "Comparison suffixes such as `_gt`, `_gte`, `_lt`, `_lte`, and `_in` are also supported."
                 ])
     CoerceInput =