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

First Paragraph Has an issue

Aberta
#3,488 0 comentários 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Linguagem predominante
HTML
Estrelas
25.5k
Forks
4k
Métricas de merge de PRs
Nenhum PR com merge em 30d

Descrição

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.

Guia de contribuição

Nenhum guia de contribuição indexado para este repositório

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Direção de pesquisa

Localize o artigo tutorial que contém o primeiro parágrafo citado e leia a explicação ao redor sobre event bubbling. Revise o parágrafo para explicar diretamente os elementos aninhados sem usar a formulação questionada e, em seguida, verifique se o artigo continua preciso e legível.

Escrita pelo modelo de indexação a partir do texto da issue.

Avaliação

Stack de tecnologia
javascript
Domínio
documentation
Tipo de issue
Documentação
Dificuldade
2/5
Tempo estimado
1-3 horas
Status de atividade
Estagnada
Clareza
Razoavelmente clara
Facilidade para iniciantes
42/100

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.