downshift-js/downshift

JSDoc comments in typings to enhance usability of props

Open

#1,057 opened on 2020年5月20日

GitHub で見る
 (2 comments) (3 reactions) (0 assignees)JavaScript (980 forks)batch import
chorehelp wanted

Repository metrics

Stars
 (11,761 stars)
PR merge metrics
 (平均マージ 6d 9h) (30d で 5 merged PRs)

説明

  • downshift version: 5.4.0

Problem description:

Currently, all descriptions of props are found through Github. They are nice and all, but it is a hassle to access the repo every time I need to read further up on the props.

Suggested solution:

Add all descriptions to index.d.ts from the README's in a JSDoc-like format (e.g. typedoc), thus having the descriptions readily available through your IDE/editor of choice

Here is an example of what it may look like in VSCode when a line was added. image

コントリビューターガイド

調査方針
READMEまたはソースコードのコメントから各プロパティの説明を抽出し、index.d.ts内にJSDocコメントとして追加します。
技術スタック
typescriptjavascriptreact
領域
frontend
Issue 種別
ドキュメント
難度新しい貢献者にとっての実装難度です。1 は非常に小さな変更、5 は専門的な作業です。
1
推定時間経験ある貢献者が調査、実装、テスト、pull request 準備にかけるおおよその時間範囲です。
1時間未満
活動状況Issue が今どれだけ取り組みやすいかを示します。新しい、活発、古い、ブロック中、またはメンテナー入力待ちなどです。
新着
明確さ期待される変更、受け入れ条件、次の手順がどれだけ明確かを示します。
明確
前提条件
TypeScriptJSDoc
初心者向け度初回貢献者にどれだけ取り組みやすいかを 1-100 で推定したスコアです。
90