为 MDN 做贡献

欢迎!当你来到了这里,说明你已经迈出了成为 MDN 贡献者的第一步!

MDN Web Docs 里面的所有内容,都是由热情的参与者们贡献的,他们来自世界各地,有着不同的身份。不过人无完人,里面也有着大量——因为参与者真的很多——等待改善的问题,比如文章的排版行文,又或者是文章内的示例和网站本身的错误等等。如果你有兴趣成为我们的一员的话,下面列出了你可以通过哪些方式帮到我们。

注意: 目前 MDN 的内容已经迁移至 GitHub ,之前编辑网站内容的途径已经失效。不论你之前是否参与编辑过 MDN 网站的内容,你都可以在初识 MDN 中了解新的参与方式。

我可以做些什么?

我们提供了很多种方式让你参与到 MDN 的建设,每种方式都对应着一类需要解决的问题,你可以根据你掌握的技术,或者自己的兴趣随意选择。后面还提供了一个简短的描述,希望可以帮助你更好地理解它们。

如果你不知道该从哪入手,我们随时欢迎你向我们寻求帮助

需要优先解决的任务

这部分内容较详细地列出了我们最关注的的问题,有的是因为关系到网站最重要的功能,有的则是因为积压了庞大的工作量,抑或是两者皆有。如果不介意的话,我们希望你能优先完成这些任务。

任务类型 任务描述 必备能力
改正内容错误 在 MDN 文档中被发现的一些问题会被提交到 content repo (你在某些内容中发现的错误可能属于sprints repo,这是之前的遗留内容,你大可以忽略它们)。你可以看到里面有不少问题,无论你愿意做点什么,我们都很感激。
  • 对要修改的内容,你需要对内容涉及到的技术(类似 JavaScript、CSS 等)有一定的了解。
  • 基本的英语读写能力(不擅长也没关系,我们可以帮你)。
审核内容修改 Content repo 每时每刻都会收到人们提交的内容修改, 我们需要有人来审核它们。在 REVIEWING.md 里介绍了我们审核工作的流程,以及如何加入进来。
  • 对要修改的内容,你需要对内容涉及到的技术(类似 JavaScript、CSS 等)有一定的了解。
  • 基本的英语读写能力(不擅长也没关系,我们可以帮你)。
帮助网站上的初学者 (en-US) 我们的 Web 开发教程非常热门,论坛上也有许多初来乍到的爱好者,他们有很多疑问等待有经验的人帮助他们解决。
  • 对要修改的内容,你需要对内容涉及到的技术(类似 JavaScript、CSS 等)有一定的了解。
  • 对帮助初学者有足够的耐心与热情。
  • 流畅的英语交流能力(当然要求也没那么严格)。

我们后续还会在这个表格添加更多的任务。

优先级

我们使用不同的标签来区分不同等级 issue 的重要性,标签从 P0 开始重要性依次递减,数字则依次增大(P0、P1、P2……)。你也可以从这个方面着手,找到最适合你的任务。

不同优先级的分类标准,你可以在 MDN 文档优先级 (en-US)找到详细的描述。

其他类型的任务

如果你对上面这些较优先的任务不感兴趣,下面列出了一些其他类型的任务。这些任务一般没那么紧迫,但依然对我们有帮助。

如果你对文字感兴趣,下面这些任务可能适合你:

如果你对代码感兴趣,可以试试下面这些任务:

如果你对代码和文章这两者都感兴趣,下面列出的任务或许适合你:

注意:如果你在使用 MDN 时发现了一些错误,却不知道怎么改正,你可以提交一个 issue。记得写个合适的标题(你可以在 issue 列表里参考一下别人的格式),并简单描述一下问题的位置和涉及到的内容,这样可以方便别人确定问题到底出在哪。如果你发现的问题属于翻译上的错误,向 Translated-content Repo提交一个 issue 会更加合适。

相关链接

MDN 使用指南
对你在社区参与中可能遇到的问题,下面列出的文章提供了较为完全的指导。
MDN 的本地化
2020年12月14日开始,MDN 将运行在基于 Github 的 Yari 平台上。新的平台也使 MDN 在许多方面发生了改变,这些变化基本上都对我们的工作有不同程度的改进,不过,在内容本地化的工作方面,变化可能看起来会更激进一些。许多的英语区域外的内容本地化工作被中止了,其中的内容长久未更新或活跃人数太少都是可能的原因。在将来,我们希望有更好的机制,来管理这些内容的本地化工作。
初识 MDN
我们是一个开放包容的开发者社区群体,目标是为更美好的互联网提供资源,无关浏览器或平台。任何人都可以参与到我们中来,你的每一分贡献都会让我们更强大。与我们一起,持续推动互联网技术向更伟大的方向革新——就在这里,与你一起。
向 MDN Web Docs 发送反馈
在使用过程中,如果遇到了问题或者对我们有些建议,那你就来对地方了。只要有兴趣反馈你的意见,Mozilla Community 永远欢迎你的加入。在此,向你提前表达我们的谢意!
改正内容错误
MDN 文档的问题被报告在 content 仓库的 issues中(也会有一些在 sprints 仓库的遗留问题)。 本文将帮助你,根据你的专业知识和空闲时间来找到最适合解决的问题,并且讲述解决这些问题的主要步骤。