reactjs / reactjs/react.dev

[Suggestion]: add explanation & illustration for the Note in the 'Passing state deeply with context' chapter

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

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

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

説明

Summary

Currently, in the Note, it says "This example uses heading levels because they show visually how nested components can override context.". However, it is unclear what this sentence means. What does it mean for a nested component to override context? I suspect that 'because they show visually how nested components can override context' is not correct, or if correct, it needs clear explanation what it means, because I personally don't get it (and I don't want to ask GPT to get a wrong answer...).

If left unchanged, this sentence risks confusing millions of learners in my opinion (myself included).

Page

https://react.dev/learn/passing-data-deeply-with-context

Details

The sentence "This example uses heading levels because they show visually how nested components can override context." is not explained. It would be useful to explain this much more explicitly. It's like throwing a sentence at a super abstract level... (which is not helpful for learners).

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

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

はじめの一歩

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

調査の方向性

Issue にリンクされている “Passing data deeply with context” ページから始め、見出しレベルと、ネストされたコンポーネントが context を上書きすることについて述べた文の周辺にある Note を読んでください。例が何を示しているのかが分かる説明と図解を追加して、この記述を明確にしてください。学習者が外部の説明を必要とせずに関係を理解できれば完了です。

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

評価

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

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

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