如何向MDN的学习区做贡献 - 学习 Web 开发 编辑

可能您是第一次看到这个页面，也可能您经过层层搜索而来。我们猜测您找到这里，是希望向 MDN 学习区做贡献——棒极了！

这篇文档将告诉您如何提高 MDN 学习区资料的质量。您可以做的事情各种各样，取决于您有多少时间，以及您的身份：初学者、Web 开发者，还是教师。

注意：这篇指南会告诉您如何撰写文章来帮助他人学习 Web。

寻找特定任务

贡献者向学习区做出贡献的方法通常是阅读文章、修复排版错误并提出改进。我们同时欢迎您向我们的 GitHub 源 添加示例。若您还想了解需要做的其他事项，请与我们联系。

在学习新知识的同时做出贡献是一件乐趣无穷的事。如果您感到迷茫或者有疑问，不用犹豫，通过邮件列表或 IRC 频道联系我们（本页底部有更详细的信息）。Chris Mills 是学习区的主题发布人——您也可以直接和他联系。

以下章节为您的任务提供概要思路。

我是初学者

好极了！对于创建学习资源和提供反馈，初学者们至关重要。作为目标受众，您对这些文章具有独特的视角，这让您成为我们团队中的无价之宝。真的，如果您正在通过某篇文章学习知识却卡住了，或者您觉得这篇文章看起来有点令人费解，您既可以自行改正，也可以把问题告诉我们以便我们去改正它。

下面是几种建议的贡献方式：

为文章添加标签（5 分钟）

为文章添加标签是最简单的贡献方式。利用标签来呈现信息是我们的特色之一，因此添加标签对我们来说是非常有价值的贡献方式。您可以先从还没有标签的词汇条目和学习文章开始。

阅读并复核词汇条目（5 分钟）

我们希望，作为初学者的您能用您的视角来审视我们所写的内容。如果您感到某个词汇条目难以理解，这说明该条目需要改进。您可以做任何觉得有必要的修改。如果您感到自己的技能不足以修改词汇条目，也可以通过邮件列表告诉我们。

撰写词汇条目（20 分钟）

这是学习新知识的最有效的方式了。挑选一个想要深入了解的概念，根据您所学的，撰写关于这个概念的词汇条目。“向他人解释”，这是巩固已学知识的最佳方式之一，既帮助您深入理解，同时也帮助了他人。这就是共赢！

阅读并复核学习文章（2 小时）

这与上述“复核词汇条目”非常类似，只是由于文章更长，因此要花更多时间。

我是 Web 开发者

太棒了！我们太需要您的专业技能了，这确保我们向初学者提供的内容技术准确。考虑到这部分内容用于供他人学习，我们希望您提供的解释尽可能表述简单，但又不至于无用。我们首先考虑易于理解，而非过度精确。

阅读并复核词汇条目（5 分钟）

我们希望作为 Web 开发者的您，能让我们的文章内容技术准确而又不至于太学究气息。您可以做任何认为有必要的修改。如果您想在编辑前讨论内容，可以通过邮件列表或 IRC 频道联系我们。

撰写词汇条目（20 分钟）

阐述技术词汇是一种很好的学习方法，它能帮助您用准确而简单的方式把握技术细节。初学者非常需要准确清晰的术语定义。我们有许多缺乏定义的术语需要您来完善，请放手去做吧！

阅读并复核学习文章 (2 小时)

这与上述“复核词汇条目”一样，只是由于文章更长，因此要花更多时间。

撰写学习文章 (4 小时或者更多)

MDN 缺少朴素直白的文章以介绍如何使用 Web 技术（HTML、CSS、JavaScript 等等）。我们还有很多陈旧的文档内容，需要复核或重构。发挥您的聪明才智，造福 Web 技术初学者吧！

创建练习、代码样例或交互式学习工具 (? 小时)

亲自实践的学习效果更佳，因此我们希望所有的学习文章都包含“主动学习 (active learning)”材料，比如练习、或者交互式内容。这些材料能够帮助用户熟练运用文章中详述的概念。制作“主动学习”材料的方式很多，比如使用 JSFiddle 或类似工具创建代码样例，或者使用 Thimble 构建可解析的交互式内容。总而言之，释放您的创造力吧！

我是教师

MDN 长期以来都拥有卓越的技术，但对于传授知识的最佳方法，我们仍然缺乏深刻的见解。我们需要教育工作者的参与，从而确保我们的材料为读者提供良好而实用的教育方法。

阅读并复核词汇条目 (15 分钟)

检查词汇条目，并对任何您认为有必要的地方进行修改。如果您想在编辑前讨论内容，可以通过可以通过邮件列表或 IRC 频道联系我们。

撰写词汇条目 (1 小时)

为了满足初学者的需求，在词汇表中对术语进行清晰简明的定义、对概念进行基本总体的描述至关重要。您的教育经验对于创建优秀的词汇条目大有裨益；我们有许多缺乏定义的术语需要您来完善，请放手去做吧！

向文章中添加插图或图表 (1 小时)

您一定了解图表在学习材料中的价值。我们的文章内容总是缺乏图表，而您正好可以大展身手。您可以从缺少图表内容的文章中选择一些，为其创建插图。

阅读并复核学习文章 (2 小时)

这与上述“复核词汇条目”类似，只是由于文章更长，因此要花更多时间。

撰写学习文章 (4 小时)

我们需要朴素直白的文章，介绍 Web 生态体系以及其他相关的功能主题。这些文章的目标是教育性，而非领域百科。文章应当涉及什么、如何表述，您在这方面的丰富经验大有帮助。

创建练习、测验或者交互式学习工具 (? 小时)

我们希望所有的学习文章都包含“主动学习 (active learning)”材料，比如练习、或者交互式内容。这些材料能够帮助用户学习并拓展理解文章中详述的概念。您可以做很多事情——创建测验、用 Thimble 构建可解析的交互式内容——总之，释放您的创造力吧！

创建学习路线 (? 小时)

为了提供循序渐进、易于理解的教程，我们需要把学习材料组织成体系化的路线。这个过程将收集已有的材料，并找出缺失的内容，然后用新文章填补空缺。