Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

docs(router): align RouteMatch API reference with the current public contract

未关闭 适合新手
#7,789 1 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

@soheilnikroo 已经在做这个了。

开始于 2026年7月12日。

  • #7800 来自 @soheilnikroo —— 未关闭

评估

难度
2/5
预计耗时
1-3 小时
新手友好度
78/100
Issue 类型
文档
描述清晰度
描述清楚
活跃度
冷清
技术栈
typescript
领域
documentation

调研方向

从 docs/router/api/router/RouteMatchType.md 开始,并将其与 packages/router-core/src/Matches.ts 进行对比,以 issue 中描述的公共契约为指导。移除过时字段和内部字段,添加指定的公共字段及 cause 值,并检查完整页面的准确性。当参考内容与预期的公共 RouteMatch API 一致,且不包含仅用于生命周期的状态时,即表示完成。

由索引模型根据 Issue 内容生成。

描述

Goal

Bring the RouteMatch API reference in line with the current public contract.

Scope

  • Remove obsolete showPending and fetchedAt entries from docs/router/api/router/RouteMatchType.md.
  • Add fullPath using its route-specific type, Route['fullPath'].
  • Add index and explain its ordering within the matched route array.
  • Update cause to include 'preload'.
  • Keep internal and lifecycle-specific match state out of the reference, including displayPendingPromise, fetchCount, preload, invalid, headers, and globalNotFound.
  • Review the complete page against packages/router-core/src/Matches.ts so the reference describes the intentional public API.

Related Work

This continues the RouteMatch reference update started in #4894

主要语言
TypeScript
星标
15.2k
派生
1.9k
平均合并
1 天 13 小时
30 天内合并 PR
76

环境准备

在 Codespaces 中打开

在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

TanStack/router 的其他 Issue

查看 TanStack/router 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。