javascript-tutorial / javascript-tutorial/en.javascript.info
First Paragraph Has an issue
Personne n'a encore pris cette issue.
- Langage dominant
- HTML
- Étoiles
- 25.5k
- Forks
- 4k
- Métriques de merge des PR
- Aucune PR mergée en 30 j
Description
I would consider revising the first paragraph.
Mainly this part:
> Isn’t it a bit strange? Why does the handler on <div> run if the actual click was on <em>?
It comes across as infantilizing and momentarily derailed my reading on a topic I was actually wanting to read about. It works well if your target audience is four to six year-olds.
Simply saying something like "this is because they are nested" or similar would do the trick.
I will concede that I am likely not the target audience. I saw the term bubbling, was unfamiliar with it, googled, saw right away from this article that it was talking about propagating events. I will still finish reading the article, since JavaScript is not my forte, but that line was a bit unexpected in an article at this level.
I will also note that the comments, overall, look to be positive, so the article is well received.
Guide de contribution
Aucun guide de contribution indexé pour ce dépôt
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Piste de recherche
Trouvez l’article de tutoriel contenant le premier paragraphe cité et lisez l’explication qui l’entoure sur l’event bubbling. Révisez le paragraphe afin d’expliquer directement les éléments imbriqués sans utiliser la formulation mise en question, puis vérifiez que l’article reste exact et lisible.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Évaluation
- Stack technique
- javascript
- 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