javascript-tutorial / javascript-tutorial/en.javascript.info
First Paragraph Has an issue
Nobody has claimed this yet.
- Dominant language
- HTML
- Stars
- 25.5k
- Forks
- 4k
- PR merge metrics
- No merged PRs in 30d
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.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Locate the tutorial article containing the quoted first paragraph and read the surrounding explanation of event bubbling. Revise the paragraph to explain the nested elements directly without the questioned phrasing, then check that the article remains accurate and readable.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- javascript
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 42/100