docs: `createLink` has no API reference page; 3 how-to guides link to a missing `#createlink` anchor
メンテナーはふだん 1 日以内に返信
評価
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 88/100
- issue の種類
- ドキュメント
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- react, typescript
調査の方向性
docs/router/api/router/ 以下にある既存の関数リファレンスページと、packages/react-router/src/index.tsx の createLink エクスポートを読みます。docs/router/api/router/createLinkFunction.md を追加し、docs/router/api/router.md の Functions に掲載して、指定された3つのハウツーガイドのリンクを更新します。リファレンスページが存在し、3つすべてのリンクがそこを指していれば完了です。
索引モデルが issue の本文から書いたものです。
説明
Which project does this relate to?
Router
Describe the bug
createLink is exported from @tanstack/react-router (packages/react-router/src/index.tsx), but it has no API reference page. Functions like createRoute, linkOptions and redirect each have a page listed in docs/router/api/router.md; createLink is not listed there, and no file under docs/router/api/ mentions it. It is only documented in the Custom Link guide (docs/router/guide/custom-link.md).
Three how-to guides link to it anyway, using an anchor that doesn't exist:
docs/router/how-to/integrate-chakra-ui.mdline 822docs/router/how-to/integrate-material-ui.mdline 716docs/router/how-to/integrate-shadcn-ui.mdline 516
Each one is:
[TanStack Router createLink API](../api/router#createlink)
There is no createlink heading or entry in docs/router/api/router.md, so the link does not lead to any createLink documentation.
Proposed fix:
- Add
docs/router/api/router/createLinkFunction.md, following the format of the other function pages. - List it under "Functions" in
docs/router/api/router.md. - Point the three how-to links to the new page.
I'd like to work on this and open a PR.
Complete minimal reproducer
Steps to Reproduce the Bug
- Open
docs/router/how-to/integrate-chakra-ui.mdand go to line 822 (the "Related Resources" section). The same link is inintegrate-material-ui.mdline 716 andintegrate-shadcn-ui.mdline 516. - See the link
[TanStack Router createLink API](../api/router#createlink). - Open
docs/router/api/router.md: there is nocreateLinkentry or heading in the Functions list. - Search
docs/router/api/for "createLink": no results.
Expected behavior
The "TanStack Router createLink API" links lead to an API reference page for createLink, like the pages that exist for createRoute, linkOptions and redirect.
Screenshots or Videos
No response
Platform
N/A, documentation issue
- Router version: main branch (commit d9b07e8)
Additional context
No response
- 主要言語
- TypeScript
- スター
- 15.2k
- フォーク
- 1.9k
- 平均マージ
- 1日 13時間
- マージ済み PR(30日)
- 76
環境構築
このプロジェクトの開発コンテナを、あなたの GitHub アカウントでブラウザ上に起動します。
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
TanStack/router のほかの issue
-
router.startViewTransition leaves the ready/finished promises unhandled, so a skipped transition throws an unhandled AbortError対応中かも @unjica が 2 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 74/100
TanStack/router#8776 · コメント 3 件 · リアクション 1 件 ·
メンテナーはふだん 1 日以内に返信
-
Router devtools crash when search params contain a BigInt (JSON.stringify in history tracking)対応中かも @A-Raphie が 6 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
メンテナーはふだん 1 日以内に返信
-
Inline scripts are duplicated after hydration when the CSP nonce is sent in a header対応中かも @gabriel-le が 27 日前に担当しました。 オープン
難易度 1/5 1時間未満 初心者へのやさしさ 90/100
メンテナーはふだん 1 日以内に返信
-
start-plugin-core: sitemap lastmod and pages.json lastBuilt are stamped with the build's wall clock (no SOURCE_DATE_EPOCH support)対応中かも @treadnot が 28 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 84/100
メンテナーはふだん 1 日以内に返信
-
Empty .ts route file is scaffolded with JSX, breaking all route generation対応中かも @nathan-logan が 32 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
メンテナーはふだん 1 日以内に返信
TanStack/router の issue をすべて見る
似ている issue
-
type: bug
難易度 2/5 1〜3時間 初心者へのやさしさ 79/100
メンテナーはふだん 1 日以内に返信
-
0️⃣ phase/new
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
-
難易度 1/5 1時間未満 初心者へのやさしさ 70/100
microsoft/playwright#43640 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 70/100