chore: docs

diff --git a/packages/router/src/experimental/route-resolver/matchers/param-parsers/strings.ts b/packages/router/src/experimental/route-resolver/matchers/param-parsers/strings.ts
index 22fa9e0b25c54fb18645d9dc43aa677de80e8de9..3e5c39a3124e344688fba60a2c2d725c159cc4b0 100644 (file)
--- a/packages/router/src/experimental/route-resolver/matchers/param-parsers/strings.ts
+++ b/packages/router/src/experimental/route-resolver/matchers/param-parsers/strings.ts
@@ -12,7 +12,11 @@ const PARAM_STRING_REPEATABLE = {
 } satisfies ParamParser<string[], (string | null)[]>
 
 /**
- * Native Param parser for strings.
+ * Native Param parser for strings. This is a permissive parser that will
+ * transform `null` and `undefined` values to empty strings in single mode, and
+ * will filter out `null` values in arrays. It's meant to be used for query
+ * params. It doesn't make much sense to use it for path params will be `null |
+ * string | string[]` (all cases combined).
  *
  * @internal
  */