在开源项目中做出你的第一个贡献 | LinuxCN Mirror
Skip to content
返回

在开源项目中做出你的第一个贡献

这是许多事情的第一步

women programming

有一个普遍的误解,那就是对开源做出贡献是一件很难的事。你可能会想,“有时我甚至不能理解我自己的代码;那我怎么可能理解别人的?”

放轻松。直到去年,我都以为是这样。阅读和理解他人的代码,然后在他们的基础上写上你自己的代码,这是一件令人气馁的任务;但如果有合适的资源,这不像你想象的那么糟。

第一步要做的是选择一个项目。这个决定是可能是一个菜鸟转变成一个老练的开源贡献者的关键一步。

许多对开源感兴趣的业余程序员都被建议从 Git 入手,但这并不是最好的开始方式。Git 是由许多有着多年软件开发经验的超级极客维护的。它是寻找可以做贡献的开源项目的好地方,但对新手并不友好。大多数对 Git 做出贡献的开发者都有足够的经验,他们不需要参考各类资源或文档。在这篇文章里,我将提供一个对新手友好的特性的列表,并且给出一些建议,希望可以使你更轻松地对开源做出贡献。

理解产品

在开始贡献之前,你需要理解项目是怎么工作的。为了理解这一点,你需要自己来尝试。如果你发现这个产品很有趣并且有用,它就值得你来做贡献。

初学者常常选择参与贡献那些他们没有使用过的软件。他们会失望,并且最终放弃贡献。如果你没有用过这个软件,你不会理解它是怎么工作的。如果你不理解它是怎么工作的,你怎么能解决 bug 或添加新特性呢?

要记住:尝试它,才能改变它。

确认产品的状况

这个项目有多活跃?

如果你向一个暂停维护的项目提交一个 拉取请求 pull request ,你的请求可能永远不会被讨论或合并。找找那些活跃的项目,这样你的代码可以得到即时的反馈,你的贡献也就不会被浪费。

这里介绍了怎么确认一个项目是否还是活跃的:

新手资源

Coala 是一个开源项目的例子。它有自己的教程和文档,让你可以使用它(每一个类和方法)的 API。这个网站还设计了一个有吸引力的界面,让你有阅读的兴趣。

文档: 不管哪种水平的开发者都需要可靠的、被很好地维护的文档,来理解项目的细节。找找在 GitHub(或者放在其它位置)或者类似于 Read the Docs 之类的独立站点上提供了完善文档的项目,这样可以帮助你深入了解代码。

Coala Newcomers' Guide screen

教程: 教程会给新手解释如何在项目里添加特性 (然而,你不是在每个项目中都能找到它)。例如,Coala 提供了 小熊编写指南 (进行代码分析的 代码格式化 linting 工具的 Python 包装器)。

Coala UI

分类的 讨论点 issue 对刚刚想明白如何选择第一个项目的初学者来说,选择一个讨论点是一个更加困难的任务。标签被设为“难度/低”、“难度/新手”、“利于初学者”,以及“ 触手可及 low-hanging fruit ”都表明是对新手友好的。

Coala labeled issues

其他因素

CI user pipeline log

7 对新手友好的组织

关于作者

Palash Nigam - 我是一个印度计算机科学专业本科生,十分乐于参与开源软件的开发,我在 GitHub 上花费了大部分的时间。我现在的兴趣包括 web 后端开发,区块链,和 All things python。


via: https://opensource.com/article/18/4/get-started-open-source-project

作者:Palash Nigam 译者:lonaparte 校对:wxy

本文由 LCTT 原创编译,Linux中国 荣誉推出



Previous Post
如何记录你在终端中执行的所有操作
Next Post
协同编辑器的历史性清单