[译] 为 Django Framework 贡献你的力量并无想象中的那么难

为 Django Framework 贡献你的力量并无想象中的那么难

当咱们准备开始编码并开源的时候,总感受无从下手。我知道,给一个精彩绝伦的代码库贡献代码的这个想法听起来是有一点吓人的。不过幸运的是,只要你愿意,不少这样的开源库会为你提供大显身手的空间。他们一样会给予咱们所须要的支持。听起来很不错吧?前端

你知道那个著名的 python 框架吗?Django!他们的网站上有一个部分叫 Easy Pickings。假如你准备开始参与开源工做并为一个精彩的代码库作贡献,这就是为你而准备的!python

在这篇博客中,我将逐步向你展现如何经过修复 Django easy pick 问题来为开源代码库作贡献的,经过这几个简单的步骤你也能够作到。接下来我将经过修复一个缺陷来从头至尾讲解这个过程,跟我来!android

发现/定位一个 bug

首先你要作的是访问 Django 的 Easy pickings部分。在那里你能够找到易于修复 ticket 和小 bug。天天都会有新的 ticket。找到没有分配给任何人的 ticket。以下图所示:ios

Alt text

本文中我选择的是 bug ticket #26026 并把它分配给我本身,接下来咱们要深刻的了解这个问题。在下图中,我只是显示了 ticket 的头部。请记得阅读完整的 ticket。git

Alt text

正如我以前所说,我已经解决了这个 bug。因此当我把这个 bug 分配给我本身,bug 将被关闭,并有一些相关的 PR。所以当你选择一个 bug 时,千万不要忘记把它分配给本身。这是为了防止其余人重复选择这个 bug。你须要在 Django 的网站上登陆,在 ticket 页面的顶部有连接。github

若是你打开 ticket 页面,你可能会看到一些关于如何解决问题的意见和方案。一般这些对你都是颇有帮助的。django

好了!咱们如今已经找到并理解了一个公开的 ticket 是什么样子的。后端

开始编码

第一步先 fork Django repo仓库。第二步,编写你的代码,并按照建议的风格进行提交Django's guidelines。能够参考一下个人提交: [1.9.x] Fixed #26026 -- Checked if the QuerySet is empty。最后发起 pull request。api

让咱们来看一下个人 pull request 并检查一下个人代码。能够看到我用了包含 ticket 的连接来注释这个 PR。app

Alt text

Alt text

简单吧,你以为呢?这是个人解决方案,只有一行代码。可是看了下面的答案我发现:

Alt text

额... 问题的缘由是我对错误的 Django 版本进行了 pull request。并且我忘记了写个人修复测试。让咱们来解决这个问题!

这是个人第二次 PR,针对 master 对我已经编写的代码进行测试。请注意个人提交名称已经变了(和个人 PR 名称一致)。

Alt text

Alt text

完成!个人 PR 已经被合并和关闭。我已经为了避免起的 Django 库作出了个人贡献!

Alt text

更多来自Vinta


掘金翻译计划 是一个翻译优质互联网技术文章的社区,文章来源为 掘金 上的英文分享文章。内容覆盖 AndroidiOS前端后端区块链产品设计人工智能等领域,想要查看更多优质译文请持续关注 掘金翻译计划官方微博知乎专栏

相关文章
相关标签/搜索