Learn web development

如何向MDN的学习区做贡献

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

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

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

寻找特定任务

贡献者们使用一个 Trello board 组织大家的任务。如果你想参与其中,创建一个 Trello 账号,并与 Chris Mills 联系以获得参与 board 的权限。

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

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

我是初学者

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

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

为文章添加标签5 分钟
为文章添加标签是最简单的贡献方式。利用标签来呈现信息是我们的特色之一,因此添加标签对我们来说是非常有价值的贡献方式。你可以先从还没有标签的词汇条目学习文章开始。
阅读并复核词汇条目5 分钟
我们希望,作为初学者的你能用你的视角来审视我们所写的内容。如果你感到某个词汇条目难以理解,这说明该条目需要改进。你可以做任何觉得有必要的修改。如果你感到自己的技能不足以修改词汇条目,也可以通过邮件列表告诉我们。
撰写新的词汇条目20 分钟
这是学习新知识的最有效的方式了。挑选一个想要深入了解的概念,根据你所学的,撰写关于这个概念的词汇条目。“向他人解释”,这是巩固已学知识的最佳方式之一,既帮助你深入理解,同时也帮助了他人。这就是共赢!
阅读并复核学习文章2 小时
这与上述“复核词汇条目”非常类似,只是由于文章更长,因此要花更多时间。

我是 Web 开发者

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

阅读并复核词汇条目5 分钟
我们希望作为 Web 开发者的你,能让我们的文章内容技术准确而又不至于太学究气息。你可以做任何认为有必要的修改。如果你想在编辑前讨论内容,可以通过邮件列表IRC 频道联系我们。
撰写新的词汇条目20 分钟
阐述技术词汇是一种很好的学习方法,它能帮助你用准确而简单的方式把握技术细节。初学者非常需要准确清晰的术语定义。我们有许多缺乏定义的术语需要你来完善,请放手去做吧!
阅读并复核学习文章 (2 小时)
这与上述“复核词汇条目”一样,只是由于文章更长,因此要花更多时间。
撰写新的学习文章 (4 小时或者更多)
MDN 缺少朴素直白的文章以介绍如何使用 Web 技术(HTMLCSSJavaScript 等等)。我们还有很多陈旧的文档内容,需要复核或重构。发挥你的聪明才智,造福 Web 技术初学者吧!
创建练习、代码样例或者交互式学习工具 (? 小时)
亲自实践的学习效果更佳,因此我们希望所有的学习文章都包含“主动学习 (active learning)”材料,比如练习、或者交互式内容。这些材料能够帮助用户熟练运用文章中详述的概念。制作“主动学习”材料的方式很多,比如使用 JSFiddle 或类似工具创建代码样例,或者使用 Thimble 构建可解析的交互式内容。总而言之,释放你的创造力吧!

我是教师

MDN 长期以来都拥有卓越的技术,但对于传授知识的最佳方法,我们仍然缺乏深刻的见解。我们需要教育工作者的参与,从而确保我们的材料为读者提供良好而实用的教育轨迹 (educational track)(?译者注:我不理解这个短语,请帮助我找到更好的译文)

阅读并复核词汇条目 (15 分钟)
检查词汇条目,并对任何您认为有必要的地方进行修改。如果您想在编辑前讨论内容,可以通过可以通过邮件列表IRC 频道联系我们。
撰写新的词汇条目 (1 小时)
为了满足初学者的需求,在词汇表中对术语进行清晰简明的定义、对概念进行基本总体的描述至关重要。您的教育经验对于创建优秀的词汇条目大有裨益;我们有许多缺乏定义的术语需要您来完善,请放手去做吧!
向文章中添加插图或者图表 (1 小时)
您一定了解图表在学习材料中的价值。我们的文章内容总是缺乏图表,而您正好可以大展身手。您可以从缺少图表内容的文章中选择一些,为其创建插图。
阅读并复核学习文章 (2 小时)
这与上述“复核词汇条目”类似,只是由于文章更长,因此要花更多时间。
撰写新的学习文章 (4 小时)
我们需要朴素直白的文章,介绍 Web 生态体系以及其他相关的功能主题。这些文章的目标是教育性,而非领域百科。文章应当涉及什么、如何表述,您在这方面的丰富经验大有帮助。
创建练习、测验或者交互社学习工具 (? 小时)
我们希望所有的学习文章都包含“主动学习 (active learning)”材料,比如练习、或者交互式内容。这些材料能够帮助用户学习并拓展理解文章中详述的概念。你可以做很多事情——创建测验、用 Thimble 构建可解析的交互式内容——总之,释放你的创造力吧!
创建学习路线 (? 小时)
为了提供循序渐进、易于理解的教程,我们需要把学习材料组织成体系化的路线。这个过程将收集已有的材料,并找出缺失的内容,然后用新文章填补空缺。

加入 Learn 社区

请选择你喜欢的方式加入我们:

文档标签和贡献者