javascript-tutorial / javascript-tutorial/en.javascript.info
First Paragraph Has an issue
还没有人认领这个 Issue。
- 主要语言
- HTML
- 星标
- 25.5k
- 派生
- 4k
- PR 合并指标
- 30 天内没有已合并 PR
描述
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.
贡献指南
这个仓库没有索引到贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
调研方向
找到包含所引用第一段的教程文章,并阅读其周围关于 event bubbling 的说明。修改该段,直接解释嵌套元素,不使用有问题的措辞,然后检查文章是否仍然准确且易读。
由索引模型根据 Issue 内容生成。
评估
- 技术栈
- javascript
- 领域
- documentation
- Issue 类型
- 文档
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 活跃度
- 停滞
- 描述清晰度
- 基本清楚
- 新手友好度
- 42/100