从Mozilla开发/对Fennec的贡献开始

Question

这是我第一次尝试为Mozilla做贡献。我浏览了几篇文章和文档/资源，了解了开始时最好的第一步。我从这个页面http://whatcanidoformozilla.org1开始，选择从1开始。

在最初的修补过程中，我被带到了涉入，最终，工作流程资源公司建议，最好的开始方法是找到一些简单的bug，并为它提出一个修补程序。

于是我去了http://www.joshmatthews.net/bugsahoy/?java=1&simple=1，这个特定的错误引起了我的注意。对该bug的描述提到了以下内容：

我们在DB实现中共享(或可以共享)一些方法，比如附加PARAM_SHOW_DELETED、PARAM_LIMIT或PARAM_PROFILE。 这些信息目前分布在LocalBrowserDB、TabsAccessor、URLMetadata等各个领域。把这些清理干净就好了。

问题1.现在我如何获得更多关于bug究竟是什么以及需要做什么的上下文？

到目前为止，似乎已经有两个补丁提交了我所理解的(如果我的理解是错误的，请纠正)。因此，为了获得有关bug的一些上下文，我继续打开了提交的第一个补丁这里。

它至少让我知道了需要修复的代码本身到底在哪里。我发现它是这里

问题2 :我是否在正确的轨道上找到了需要修复的代码？

问题3 :即使在到达DBUtils.java文件之后，我也找不到任何关于类基本上是做什么的文档，也找不到它适合于全局的地方。有人能帮我做这件事吗，我该如何弄清楚一个类应该做什么等等，或者至少有一些相关的文档？

Answer 1

你走在正确的道路上。基本上，我能为Mozilla做些什么？网站是让您发现您可能感兴趣的项目的一种快速而简单的方式，因此它是获得编码贡献的第一个网关。

话虽如此，你还是很好地挑选了一个bug开始。但是，正如您所看到的，bug已经被其他人处理(标记为已分配)。你最好的选择是找到一些新的“好的第一个bug”来处理。这可能是一个复杂的任务，因为Bug的Ahoy显示，只有少数没有良好的第一次错误。

您应该通过电子邮件或IRC (后者可以获得更快的响应)尝试使用取得联系与Fennec团队。

现在，以更一般的方式回答你的问题

问题1.现在我如何获得更多关于bug究竟是什么以及需要做什么的上下文？

通常，这应该在Bugzilla的第一个注释中描述。如果不是这样的话，可以自由地在那里留言，并询问更多的方向。您还可以使用必需信息功能将报告者或bug的导师标记出来，因为它们通常更好地显示。

正如您所看到的，有人要求在评论1中提供更多的信息，并给出了一些新的方向。

通常，您不会在bug本身上找到一个带有代码的修补程序，但是您可能会找到指向文件的链接，以及更精确的关于要更改什么和如何更改的说明。如果不是的话，也可以自由选择记者和/或导师。

问题2 :我是否在正确的轨道上找到了需要修复的代码？

你走在正确的道路上。通常，如果bug上没有指向文件或DXR的链接，但是提到了一些代码，您可以使用DXR查找它，就像您做的那样。

问题3 :即使在到达DBUtils.java文件之后，我也找不到任何关于类基本上是做什么的文档，也找不到它适合于全局的地方。有人能帮我做这件事吗，我该如何弄清楚一个类应该做什么等等，或者至少有一些相关的文档？

I通常在导航Firefox代码时所做的工作，以及在文档不太清楚的类上需要更多的背景信息，就是浏览该文件的更改日志，单击DXR上右上面板中的日志按钮(当显示文件时)。它将显示影响文件的bug列表。您甚至可以追溯实现它的原始文件，以获得更多的上下文。

另一方面，如果您只对文件中的一行代码的历史感兴趣，那么指责工具就是您的朋友。它告诉你谁最后一次接触到这条线，变更集和相关的错误编号。这也可以从您可以找到日志的地方访问，这里。

但是，在DBUtils.java的情况下，类只包含一些用于数据库访问的实用函数。

要查看Firefox代码库中的某些内容是如何使用的，您仍然可以使用DXR。下面是一个样本搜索，用于DBUtils对象。