RxJS文档与GitHub代码中泛型差异原因咨询

我在学习RxJS时发现，部分函数的文档与GitHub代码中的泛型存在差异，尽管文档似乎直接由代码生成。以下是两个示例：

catchError 示例 #

文档中的定义 #

catchError(
  selector: (err: any, caught: Observable<T>) => O
): OperatorFunction<T, T | ObservedValueOf<O>>

代码中的定义 #

export function catchError<T, O extends ObservableInput<any>>(
  selector: (err: any, caught: Observable<T>) => O
): OperatorFunction<T, T | ObservedValueOf<O>>;

concat 示例 #

文档中的定义 #

concat(
  ...inputs: [...ObservableInputTuple<T>]
): Observable<T[number]>

代码中的定义 #

export function concat<T extends readonly unknown[]>(
  ...inputs: [...ObservableInputTuple<T>]
): Observable<T[number]>;

这类情况仅出现在部分函数上，推测是有意为之，想请教为何这些函数的泛型会在文档中被省略？

这种泛型省略是RxJS文档团队的有意设计，核心原因是降低文档的理解门槛，优先展示实用信息：

1. 泛型约束属于底层实现细节
   代码里的泛型约束（比如O extends ObservableInput<any>、T extends readonly unknown[]）是TypeScript层面的类型校验规则，用来确保函数的输入输出符合类型规范，但对普通开发者来说，这些约束并不是使用函数时必须了解的内容。文档简化后，用户只需要关注泛型代表的业务含义（比如O是selector返回的可观察输入类型，T是输入的可观察对象元组），不用被复杂的类型约束分散注意力。

2. 文档的核心目标是指导使用
   RxJS文档的定位是帮助开发者快速上手函数，而不是复刻代码的类型系统细节。省略非必要的泛型约束后，文档的结构更简洁，重点更突出，开发者能更快理解函数的参数、返回值逻辑，而不用纠结类型层面的底层限制。

3. TypeDoc的自动优化
   RxJS的文档通常用TypeDoc生成，工具本身会对复杂泛型做简化处理，去掉对用户无意义的约束条件，只保留最核心的泛型占位符，让文档更易读。文档团队也会基于这个基础做进一步的人工调整，确保内容符合实用导向。

内容的提问来源于stack exchange，提问作者ARoso