javascript-tutorial / javascript-tutorial/en.javascript.info

First Paragraph Has an issue

Ouverte
#3,488 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

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

  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

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

Recevez les nouvelles issues par e-mail

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