doc: comment improvements

Author: gvergnaud

src/patterns.ts

@@ -933,7 +933,7 @@ export const number: NumberPattern = numberChainable(when(isNumber));
  *
  * @example
  *  match(value)
- *   .with(P.bigint.between(0, 10), () => '0 <= numbers <= 10')
+ *   .with(P.bigint.between(0, 10), () => '0 <= bigints <= 10')
  */
 const betweenBigInt = <
   input,
@@ -952,7 +952,7 @@ const betweenBigInt = <
  *
  * @example
  *  match(value)
- *   .with(P.bigint.lt(10), () => 'numbers < 10')
+ *   .with(P.bigint.lt(10), () => 'bigints < 10')
  */
 const ltBigInt = <input, const max extends bigint>(
   max: max
@@ -966,7 +966,7 @@ const ltBigInt = <input, const max extends bigint>(
  *
  * @example
  *  match(value)
- *   .with(P.bigint.gt(10), () => 'numbers > 10')
+ *   .with(P.bigint.gt(10), () => 'bigints > 10')
  */
 const gtBigInt = <input, const min extends bigint>(
   min: min
@@ -1077,7 +1077,7 @@ export const symbol: SymbolPattern = chainable(when(isSymbol));
  * [Read the documentation for `P.nullish` on GitHub](https://github.com/gvergnaud/ts-pattern#nullish-wildcard)
  *
  * @example
- *   .with(P.nullish, () => 'will match on null or undefined')
+ *   .with(P.nullish, (x) => `${x} is null or undefined`)
  */
 export const nullish: NullishPattern = chainable(when(isNullish));
 
@@ -1087,7 +1087,7 @@ export const nullish: NullishPattern = chainable(when(isNullish));
  * [Read the documentation for `P.nonNullable` on GitHub](https://github.com/gvergnaud/ts-pattern#nonNullable-wildcard)
  *
  * @example
- *   .with(P.nonNullable, () => 'will match on null or undefined')
+ *   .with(P.nonNullable, (x) => `${x} isn't null nor undefined`)
  */
 export const nonNullable: NonNullablePattern = chainable(when(isNonNullable));