我们是一个由开发者和作者组成的开源社区,目的是为了建设一个更美好的网络,无论是品牌、浏览器或是平台。 任何人都可以参与,每个人的贡献都会让我们更强大。我们可以一起继续推动Web创新服务于更广泛的利益。我们和你一起在这里开始。
MDN的每一个部分(文档,演示,和网站本身)都是由开放的社区创建的。任何人都可以贡献自己的力量,请加入我们!
三个简单的 MDN 步骤
MDN 是一个维基,即意味着任何人都可以向其添加和编辑内容。你不必是一个程序员或了解许多涉及技术方面的知识。这里有很多需要完成的任务,从简单的(如校对和纠正拼写)到复杂的(如写作API文档)。
作贡献很容易也很安全。即使你犯了一个错误,别人也能很容易更正它。即使你不知道该做什么,或者你的语法不是很好,别担心!我们有一个团队,我们团队的工作就是竭尽全力优化MDN的内容,这会确保你的文档是整洁和符合标准的。所以请在此分享你的知识,发挥你的所长,并且对我们的社区给予信任,相信MDN在大家的共同努力下会越来越好。
步骤 1: 创建一个MDN账号
在开始给MDN贡献自己的知识前,你需要有一个MDN帐号。有关详细信息请参阅(如何创建一个帐户)。
步骤 2: 选择一个任务并完成
现在你已经登录,在下面的列表里阅读有关不同任务的描述,并决定哪一个任务是最吸引你的。你可以选择任何你喜欢的任务并开始贡献你的知识。
步骤 3: 做任务
一旦你决定了想做什么任务,找一个特定的页面、代码示例,等等。然后去做吧!
别担心做得是否完美;其他MDN贡献者会来帮助修复你的错误和疏忽。如果想在做“真正”的东西之前先实验下,你可以选择编辑沙盒网页。 如果有问题,你可以通过参阅在邮件列表中的信息社区、网页、聊天频道等多种方式来找到你想要的答案。
当完成你的任务时,若恰巧时间空闲,你可以选择另一个项目,或者看看下面你可以做的其它事情。
可能的任务类型
基于你的技能和兴趣,你有很多方法可以帮助到MDN。尽管一些任务可能是艰巨的,但同时我们也有很多相对简单的任务。很多人只需要五分钟(或更少!)。通过做任务和阅读它的简短描述,你会发现每一种类型的任务通常都是需要近似的时间的。
选项 1: 我喜欢文字
你可以帮我们审查或编辑现有的文档,并对它们应用正确的标签。
- 设置一个页面的摘要(5-15分钟)
- 编辑评论(5–30分钟)
- 随着新的信息更新现有的文章(5 分钟-1小时)
- 写关于新的技术或API的一篇文章(30 分钟-2小时)
注意:在你审查已有的文章或者编写新的文章之前,最好先看一下我们的风格指南,这样有助于确保大家写出的文章的风格是一致的。
选项 2: 我喜欢代码
我们需要更多的代码示例!你也可以帮助建立我们的网站平台,Kuma!
- 转换示例代码是“可用的”(30分钟)
- 建立一个Kuma的编程环境(1小时)
- 发送你的代码补丁到Kuma的代码库(1小时)
- 提交一个新的演示(1小时)
选项 3: 我喜欢文字和代码
我们有需要的技术和语言技能的任务,像写新文章,审查技术的准确性,或改编文档等。
- 标记JavaScript网页(5分钟)
- 推进MDN在你自己的网站(5分钟)
- 技术评论(30分钟)
- 更新API页面布局(30分钟)
- 写一个话题你所熟悉的新文章(1小时以上)
选项 4: 我想MDN上有我的语言
所有的本地化和翻译工作是由我们令人惊讶的MDN社区志愿者做的。
选项 5: 我发现了一些错误的信息,但我不知道该怎样修复它
你可以在 Bugzilla 上提交 bug。(5分钟)
注意在新建 bug 时要按照下面说的规则填写:
Bugzilla 页面中的字段名 | 应该选择或填写的内容 |
product |
Developer Documentation |
component |
[尽可能选择正确的 component,如果实在不知道选哪个,就选 "General" 好了] |
URL |
你发现问题的页面地址 |
Description |
尽可能把错误的信息描述清楚,还可以附上一些链接来证实自己的说法。 |