reactjs / reactjs/react.dev

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

Ouverte
#7,652 1 commentaire 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

type: documentation
Langage dominant
JavaScript
Étoiles
11.8k
Forks
7.9k
Merge moyen
1 j 11 h
PR mergées (30 j)
11

Description

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).

Guide de contribution

Ouvrir le guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Commencez par la page “Passing data deeply with context” liée dans l’issue et lisez la note autour de la phrase concernant les niveaux de titre et les composants imbriqués qui remplacent le contexte. Clarifiez cette affirmation avec une explication et une illustration montrant ce que démontre l’exemple ; le travail est terminé lorsque les apprenants peuvent comprendre la relation sans avoir besoin d’une explication extérieure.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
javascript, react
Domaine
documentation
Type d'issue
Documentation
Difficulté
2/5
Temps estimé
1-3 heures
Activité
À l'abandon
Clarté
Plutôt claire
Accessibilité débutants
42/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.