General issues with discoverability of information
まだ誰も着手していません。
評価
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 初心者へのやさしさ
- 25/100
- issue の種類
- 機能追加
- 明瞭さ
- 説明が足りない
- 活発さ
- 停滞
- 技術スタック
- typescript
- 領域
- documentation, search
調査の方向性
https://www.typescriptlang.org/ から始めて、サイトの「assert」と「asserts」に対する検索動作を確認し、リンク先の narrowing ページにある「Assertion Functions」セクションと比較します。Issue が参照しているコンテンツ(関連する「What’s New」の情報を含む)がサイト検索で見つけられるようになれば完了です。
索引モデルが issue の本文から書いたものです。
説明
Page URL: https://www.typescriptlang.org/
Issue: The website search does not include any "What's New" sections.
Yes, this could result in outdated or duplicate content in search, however, there is currently no way to find any important features that aren't listed elsewhere. Searching for "assert" or even "asserts" does not bring up any information about the "asserts" keyword. Even searching for "assertion does not find this section https://www.typescriptlang.org/docs/handbook/2/narrowing.html#assertion-functions here. So perhaps there are just bugs with searching in general? I'm not really sure.
A more long term solution would be to provide a community editable wiki, something akin to cppreference, tsreference dot com if you will. You might be uncomfortable with not having direct authority over all the edits made, but I believe it would be an improvement on the status quo. If you're not willing to hire dedicated maintainers for the official site, then you might as well provide a platform for others to do the job for you. You can't have your cake and eat it too unfortunately.
This would lift a lot of the burden of writing the handbook as well. It wouldn't be so crippling to be missing newer information from it when there's always a bleeding edge reference that one can look to. The handbook's purpose gets freed up as a beginner resource instead of a catch-all resource. Microsoft can be satisfied they are only publishing approved ideas of the language, the TS team doesn't have as much pressure from the community to focus on it, and new information is still more accessible than it was before.
- 主要言語
- TypeScript
- スター
- 2.6k
- フォーク
- 1.5k
- 平均マージ
- 2日 12時間
- マージ済み PR(30日)
- 8
コントリビューションガイド
このリポジトリのコントリビューションガイドは索引されていません
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
microsoft/TypeScript-Website のほかの issue
-
難易度 1/5 1時間未満 初心者へのやさしさ 88/100
microsoft/TypeScript-Website#3611 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
microsoft/TypeScript-Website#3607 ·
-
難易度 1/5 1時間未満 初心者へのやさしさ 65/100
microsoft/TypeScript-Website#3039 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
microsoft/TypeScript-Website#2998 ·
-
難易度 3/5 1〜2日 初心者へのやさしさ 68/100
microsoft/TypeScript-Website#3614 ·
microsoft/TypeScript-Website の issue をすべて見る
似ている issue
-
bug(cli): hapi doctor inline-media prints a fabricated B:\ helper-script path in packaged installs オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 70/100
-
Crush オープン
難易度 1/5 1時間未満 初心者へのやさしさ 85/100
catppuccin/catppuccin#3125 ·
-
Add a SECURITY.md オープン
難易度 1/5 1時間未満 初心者へのやさしさ 90/100
ElementsProject/cln-application#167 · コメント 1 件 · リアクション 1 件 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
Quantco/pnpm-licenses#17 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100