新贡献者¶
此页面面向那些刚接触 Mozilla 并希望为与 Marionette Python 测试、WebDriver 规范测试以及相关测试工具和框架相关的 Mozilla 源代码做出贡献的人员。Mozilla 同时拥有 Git 和 Mercurial 存储库,但本指南仅介绍 Mercurial。
如果您遇到问题或有任何疑问,请查看下面的 资源 部分,并 **不要犹豫,提出您的问题**。:) 这些步骤的目的是确保您的开发环境基础能够正常工作。一旦完成,我们就可以开始让您参与实际的 Bug 修复工作,太棒了!
账户和沟通¶
设置一个 Bugzilla 账户(如果您愿意,还可以创建一个 Mozillians 个人资料)。请在这两个账户中都包含您的 Element 昵称,以便我们更轻松地与您合作。例如,Eve Smith 会将 Bugzilla 名称设置为“Eve Smith (:esmith)”,其中“esmith”是 Element 昵称。
为了与我们进行直接沟通,设置 Element 将非常有益。请确保也按照链接文档中的说明注册您的昵称。
加入我们的 #webdriver:mozilla.org 频道,并向团队成员介绍自己。:whimboo、:jdescottes 和 :jgraham 都熟悉 Marionette。我们很友好,我保证,但由于时区差异、休假等原因,我们可能无法立即回复。所以请耐心等待。
当您想在 Element 上提问时,尽管提出来,即使看起来没有人在线/回复。提供详细的信息,以便我们更有可能帮助您。如果您没有立即得到回复,请在几个小时后再次查看 - 期间可能有人已经回复了您。
如果您在 Element 上联系我们遇到困难,欢迎您发送电子邮件到我们的 邮件列表。最好在您的电子邮件中包含您的 Element 昵称。
获取代码和运行测试¶
按照 贡献 中的文档了解我们的项目,以及哪些项目最符合您的兴趣。您还将学习如何获取 Firefox 源代码、构建自定义 Firefox 版本以及如何运行测试。
处理 Bug 并获取代码审查¶
一旦您熟悉了测试工具和测试代码,您就可以开始进行您的第一次贡献。提交和验证补丁的必要步骤在 补丁 中进行了说明。
资源¶
使用 searchfox 搜索 Mozilla 的代码库,查找 Marionette 代码 和 Marionette 客户端/框架。
另一个 面向新贡献者的指南。它已经很久没有更新了,但如果您在某些方面遇到困难,它是一个很好的通用资源。与您最相关的部分是关于 Bugzilla、Mercurial、Python 和开发流程。
更多通用资源可在以下简短的 指南 中找到,:maja_zf 在 2015 年编写了该指南,以帮助学生开始参与开源贡献。
关于通用开源实践的教科书:实用开源软件探索
如果您更喜欢使用 Git 而不是 Hg,请参阅 Gecko 开发的 Git 工作流 和/或 :ato 的这篇博文。