为 MDN 做贡献
MDN Web 文档需要你的帮助!我们有大量需要完成的工作,比如错别字修正、示例编写、内容讨论,等等。随着用户数量的增长,这些工作也随之增加。下面列出了你可以通过哪些方式帮到我们。
备注: 如果你之前没有参与编辑过 MDN 网站的内容,你都可以在初识 MDN 中了解参与方式。你已经到达了第二步:选择一个任务。
我可以做些什么?
我们提供了很多种方式让你参与到 MDN 的建设,每种方式都对应着一类需要解决的问题,你可以根据你掌握的技术,或者自己的兴趣随意选择。后面还提供了一个简短的描述和所需要的事件,希望可以帮助你更好地理解它们。
如果你不知道该从哪入手,我们随时欢迎你向我们寻求帮助。
需要优先解决的任务
这部分内容较详细地列出了我们最关注的的问题,有的是因为关系到网站最重要的功能,有的则是因为积压了庞大的工作量,抑或是两者皆有。如果不介意的话,我们希望你能优先完成这些任务。
任务类型 | 任务描述 | 必备能力 |
---|---|---|
改正内容错误 | 在 MDN 文档中被发现的一些问题会被提交到 content repo。你可以看到里面有不少问题,无论你愿意做点什么,我们都很感激。 |
|
审核内容修改 | content repo 每时每刻都会收到人们提交的内容修改,我们需要有人来审核它们。在 REVIEWING.md 里介绍了我们审核工作的流程,以及如何加入进来。 |
|
帮助网站上的初学者 | 我们的 Web 开发教程非常热门,论坛上也有许多初来乍到的爱好者,他们有很多疑问等待有经验的人帮助他们解决。 |
|
我们后续还会在这个表格添加更多的任务。
优先级
我们使用不同的标签来区分不同等级 issue 的重要性,标签从 P0 开始重要性依次递减,数字则依次增大(P0、P1、P2……)。你也可以从这个方面着手,找到最适合你的任务。
不同优先级的分类标准,你可以在 MDN 文档优先级找到详细的描述。
其他类型的任务
如果你对上面这些较优先的任务不感兴趣,下面列出了一些其他类型的任务。这些任务一般没那么紧迫,但依然对我们有帮助。
如果你对文字感兴趣,下面这些任务可能适合你:
- 为现有文章补充新的信息(需时:5 分钟到 1 小时)
- 在术语表里新增一个条目(需时:15 分钟到 1 小时)
如果你对代码感兴趣,可以试试下面这些任务:
- 让示例代码以预期的方式展示出来(需时:15 分钟到 1 小时)
- 完善 Yari 平台(需时:1 小时)
- 新建一个可交互的示例(需时:1 小时)
如果你对代码和文章这两者都感兴趣,下面列出的任务或许适合你:
- 撰写新的或完善现有 API 参考(需时:30 分钟到 2 小时或更长)
- 写一篇文章分享你熟悉的技术领域(需时:1 小时或更长)
- 添加或更新参考页面列出的浏览器兼容性(需时:30 分钟到 1 小时)
备注: 如果你在使用 MDN 时发现了一些错误,却不知道怎么改正,你可以提交一个 issue。记得写个合适的标题(使用“Dead link”而不说明这个链接在哪里是没有太大帮助的)。如果你发现的问题属于翻译上的错误,向 translated-content 仓库提交一个 issue 会更加合适。