译介 | 成为开源社区贡献者之旅

原文链接
本文首发于 Jenkins 中文社区

作为一名软件工程师,这些年来在我工作过的不同公司里用到过许多开源软件(包括框架、库、工具等)。
然而,在此之前我从没有以一名贡献者的身份参与过开源项目。

自从我向 Jenkins 提交第一个简单又滑稽的 commit 已经过去六个月(2018 年 9 月)了,
我也尝试过作出更多贡献。然而总的来说,向开源项目贡献代码是具有挑战的,
特别是像 Jenkins 这样有着很长生命周期的项目,项目中不乏遗留代码和系统知识。
它通常难以入手,也很难想到一个计划来持续贡献使你的付出从长远看来是有意义的。

对于 Jenkins 社区来说,我在尝试加入社区时所遇到的困难是其它人也有可能会面临的,
因此我决定分享我成为 Jenkins 活跃贡献者的心路历程。

我计划大概每月发布一篇博文来描述我的这段旅程,我将从简单容易入手的项目开始,
随着时间推移再介绍更加复杂的项目。

从哪开始

jenkins.io

要成为 Jenkins 的贡献者,首先会看到的就是 jenkins.io,
在顶部导航中”社区”下拉列表里第一个”参与”的链接就能将我们带到”参与和贡献”这个页面。

在这个页面中列举了我们能够参与 Jenkins 项目和社区的许多方式。尽管它展示了所有可能的选项供读者选择,但一下子看上去令人有些无所适从。

译介 | 成为开源社区贡献者之旅

为何不修复它/h3>

这是一个好机会,我用它来向新人展示开始贡献是多么容易。

创建代码仓库分支

第一步,通常是 fork 代码仓库,并克隆到本地。

进行修改

下一步就是对相应文件进行修改。我创建了一个新的分支 “alternative-awestruct-link” 并对它作了如下修改:

译介 | 成为开源社区贡献者之旅
一旦命令执行完成,如果没有出现报错,我们就可以进行下一步:创建 Pull Request

创建 PR

把我的改动 commit 并 push 到远程库以后,我就需要创建一个 PR 了。
有一个简单的方法,只需单击推送完成后在 git 日志中显示的链接,如果愿意的话也可以通过 GitHub UI 创建 PR;
或者甚至可以使用 GitHub CLI 的 “hub” 来完成它。

这次我直接点击了链接,它将我跳转到 Github 的创建 PR 页面,我在这个页面上添加描述并创建了 PR。

译介 | 成为开源社区贡献者之旅
如果想看到执行的细节,可以点击 “Show all checks” 链接:

译介 | 成为开源社区贡献者之旅

我已经作出了贡献!

我做的这个贡献是微不足道的,它的复杂性很小,如果你的目标在于为 Jenkins 项目本身贡献代码,它可能看起来不是很有趣。

然而对于我作为一名贡献者,这是一个熟悉代码库、贡献指南、jenkins.io 网站背后的技术的很好的方式;
并且最重要的是,我开始“放下恐惧”,为 Jenkins 这样的开源项目做出了贡献。

因此,如果你同我一样,请不要犹豫。来吧,找到你自己的第一个贡献。每一个细节都很重要!

来源:P01son

声明:本站部分文章及图片转载于互联网,内容版权归原作者所有,如本站任何资料有侵权请您尽早请联系jinwei@zod.com.cn进行处理,非常感谢!

上一篇 2019年4月21日
下一篇 2019年4月21日

相关推荐