reactjs / reactjs/react.dev

Improve contextType docs

オープン
#1,842 コメント 1 件 リアクション 1 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

主要言語
JavaScript
スター
11.8k
フォーク
7.9k
平均マージ
1日 11時間
マージ済み PR(30日)
11

説明

See confusion in https://github.com/facebook/react/issues/13969.
Specific action items:

  • Clarify .contextType is available only since 16.6 (and corresponding RN/Expo release)
  • Clarify you may not be seeing it due to circular deps, and best practice is to declare it in a separate file
  • People sometimes get confused thinking that createContext value is the one you need to "update", we need to explain it's driven by state
  • Need more coherent doc structure

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

調査の方向性

まず、既存のcontextTypeドキュメントとissue 13969で説明されている混乱を読んでください。React 16.6の利用可能性、循環依存関係に関する指針、および状態駆動のcreateContextの使用方法を明確にしたうえで、資料をより一貫した構成に再編成してください。ドキュメントでは、列挙されている混乱それぞれを扱う必要があります。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
javascript, react
領域
documentation
issue の種類
ドキュメント
難易度
3/5
見積もり時間
1〜2日
活発さ
停滞
明瞭さ
おおむね明確
初心者へのやさしさ
35/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。