寻找合适的首个 Issue 🔎#

恭喜你成功构建了 Arrow 库!

下一步是找到一些工作来做。如前所述,你可能已经想到了要修复的 bug 或要实现的新功能。或者你仍然需要一个需要处理的 Issue,并且需要一些帮助来找到它。

在这两种情况下,我们都使用 GitHub 作为 Issue 追踪器。

创建 Issue 后,你可以在 GitHub 评论中开始讨论它。

GitHub 标签#

为了方便你找到适合新手贡献者的 Issue,我们在一些 GitHub Issue 中添加了“good-first-issue”标签。

另请参阅

搜索合适的首个 Issue good-first-issue 标签列表

标有“good-first-issue”的 Issue 应该只需要两天或一个周末就能修复。一旦你深入代码,你可能会发现 Issue 并不容易解决 - 因为问题可能比处理该 Issue 的人预期的要难。请不要犹豫,在评论中写出来。

注意

当你找到一个你想处理的 GitHub Issue 时,请在该 Issue 的评论部分提及你的兴趣;这样我们就知道你正在处理它。当工作开始时,考虑将 Issue 分配给自己(Issue 分配)。

此外,请不要犹豫在评论中提问。你可以获得一些关于从哪里开始以及类似问题已经如何解决的提示。

如果 Issue 已经被分配了呢?如有疑问,请在 Issue 中评论,询问他们是否介意你尝试提交一个 Pull Request;将没有回复理解为你可以继续进行。

提问 如果你对从哪里开始或采取什么方法有疑问,请务必提问,可以在 GitHub Issue 本身或开发邮件列表中提问。如果你这是第一次贡献代码,那么这样做尤其是一个好主意,这样你就可以了解一下该项目这部分的核心开发者认为好的解决方案是什么样的。为了获得最佳效果,请提出具体、直接的问题,例如

  • 你认为 $PROPOSED_APPROACH 是正确的方法吗?

  • 我应该在哪个文件(或文件)中进行更改?

  • 代码库中是否有任何相关内容可以供我学习?

如果你问了这些问题但没有得到答案,可以再次询问。

注意

在你创建或选择要处理的 Issue 后,不要忘记创建一个新的分支!请遵循 Pull Request 生命周期 部分中的说明,或遵循下一节:在 Arrow 代码库中工作 🧐