本文由 Jérémie Patonnier 撰写,这篇文章 最初发表在法语 中。两年来,Jérémie 一直是 MDN 的活跃贡献者。他每周三晚上在 Mozilla 巴黎办公室组织简短的文档冲刺。在这些活动中,人们会提出很多关于 MDN 以及如何贡献的问题。以下是最常见的问题,希望它们能帮助您了解如何参与 MDN 的贡献。
什么是 MDN?
请不要笑,你无法想象我听到这个问题的次数。
简单地说,MDN 就是 Mozilla 开发者网络。它是一个网站,集中了关于 Mozilla 产品的大部分文档。基本上,该网站包含三种资源:
- 学习如何使用 Web 技术的文章和外部资源链接
- 现代 Web 浏览器中可用的尖端 Web 技术演示(这些演示来自 John Karahalis 组织的每月 Dev Derby 比赛)
- Mozilla 技术的参考文档(API、元素、属性、特性),更重要的是,所有开放 Web 技术的参考文档(HTML、CSS、JavaScript、SVG、WebGL 等)
最后一部分,开放 Web 文档,是最重要的(在数量和质量方面),也是 Mozilla 目前投入最大努力的部分。需要提的一点是,这些文档是与浏览器无关的,包含所有浏览器的兼容性表格和实现说明,而不仅仅是 Firefox。
即使这些文档可以被认为是目前 Web 上最好的文档之一,但它远未完成,欢迎您帮助填补空白;)
贡献很难吗?
一点也不,相反,它非常简单。我认为这是对 Mozilla 贡献的最简单方式(无需处理 Bugzilla :-P)
实际上,要为 MDN 贡献,您需要两样东西:
- 贡献的意愿
- MDN 上的用户帐户
仅此而已。
最难的事情是在网站右上角找到“登录”按钮,它夹在搜索栏和难看的白色 Mozilla 标签之间——是的,是的,是的,确实不是最佳位置。点击它后,系统会提示您输入电子邮件地址和密码(MDN 使用 Mozilla Persona/BrowserID)。然后,在下一页,您只需提供一个“用户名”来标识您在 MDN 上的贡献,然后您就可以开始贡献了。
另一方面,贡献也非常简单。基本上,MDN 是 80% 的维基。因此,在维基的每个页面上,您都会找到一个“编辑”按钮(在右上角)。点击它将页面内容加载到 WYSIWYG 编辑器中(别担心,如果您想成为硬核用户,可以切换到原始 HTML 编辑)。进行您想做的所有更改并保存它们(点击左上角的“保存”按钮)。恭喜您,您已完成了对 MDN 和 Mozilla 的首次贡献:没有愚蠢的发布流程、没有延迟、没有审查(当然,您可以请求审查,但不是必需的)——太容易了 :)
我能做什么,从哪里开始?
简短的答案是“你想做什么就做什么,你想从哪里开始就从哪里开始”。不幸的是,经验告诉我,这不是新手期望的答案。
基本上,您可以在 MDN 上做两件事:
- 向每月举行的 Dev Derby 演示比赛提交演示,如果您是开发者,这非常酷。
- 如果您有写作的热情,可以为文档贡献。
为文档贡献可以通过多种方式完成,具体取决于您参与的时间和意愿:
- 撰写新文章
这是最耗时的贡献。但是,它也是对大多数人最有用的贡献。 - 本地化内容
如果您熟悉除英语以外的语言,那么将现有材料翻译成该语言是个好主意。并非每个人都使用英语,让 Web 对所有人开放非常重要。 - 编写代码示例
解释很好,但示例更好。很多时候,一个好的示例比五段废话文本更能让人理解。因此,编写代码示例是最有用的贡献之一,MDN 非常需要更多代码示例。 - 审核内容
正如我之前所说,MDN 上的审核流程非常有限,但贡献者可以明确要求审核(通过标记系统)。这些可以是编辑审核,也可以是技术审核。(在页面上查找 `NeedsTechnicalReview` 或 `NeedsEditorialReview` 标签;如果页面正常,请删除该标签。)如果您只有少量时间,那么这将是一个非常有用的贡献,可以帮助很多人。 - 更新兼容性表格
MDN 的开放 Web 文档正变得越来越与浏览器无关。为了实现这一目标,MDN 上有许多页面包含浏览器兼容性表格。它们使用户能够了解哪些 API、元素、属性或特性对每个浏览器可用。这非常有用,添加一些兼容性数据只需五分钟。毫无疑问,这是为 MDN 贡献的最简单、最快速的方法。
最后一点提示。为开放 Web 文档贡献是一项艰巨的任务,没有人能单独完成。因此,最好将精力集中在自己感兴趣的主题上。如果您想研究某个特定主题,请知道 MDN 有“主题驱动程序”可以帮助您;请随时与他们联系。他们非常乐意为您提供帮助。
为了补充这一点,MDN 上有两个入门页面可能非常有用:
结论
如您所见,为 MDN 贡献非常简单。如果您想了解更多信息,请随时在 IRC 上的 irc.mozilla.org 的 #devmo 频道或通过我们的 邮件列表/谷歌群组 dev-mdc 提问。如果您想与某人交谈,最好的切入点是 Eric Shepherd(又名 Sheppy)、Janet Swisher 和 Jean-Yves Perrier(Teoli)。这三个人是专门从事 MDN 的 Mozilla 员工,所以不要犹豫与他们联系;他们报名参加了这项工作 :-P
文档万岁 :)
关于 Jeremie Patonnier
Jeremie 是 Mozilla 开发者网络的长期贡献者/员工,自 2000 年起就是一名专业的 Web 开发人员。他提倡 Web 标准,编写文档,创建各种关于 Web 技术的内容,并希望让所有人都能使用这些技术。
4 条评论