logo

开源初学者指南(二):怎样才是一个优秀的开源贡献者

作者:OSCHINA2021.09.17 10:19浏览量:102

简介:这需要你头脑冷静、善于沟通、多才多艺,并且有耐心。

原文:The Beginner’s Guide to Open Source, Part 2: What Makes a Great Open Source Contributor? 作者:Vi Tran,编译:御坂弟弟

在上一篇中,本文讨论了开始参与开源项目的五个方法。但是,怎样才能成为一个优秀的贡献者呢?这需要你头脑冷静、善于沟通、多才多艺,并且有耐心。

保持冷静,善待他人

提交拉取请求(PR)时要牢记项目是第一位的。你提交的 PR 是否能帮助项目发展,为用户增加价值?如果答案是肯定的,就提交 PR。如果答案是否定的,那就好好想想如何调整你的 PR 来增加价值。

开源项目允许用户跨社区协作,这可能会在代码审查过程中的 PR 和问题提交中带来不同的意见。如果你的 PR 没有被立即接受,不要担心。项目维护者和你一样,都希望项目对社区有价值。

但当你成为项目维护者时,会发生什么?如果你正在审查一个拉取请求,应该给出建设性的意见,并引导用户完成修改。对有可能优化的地方发表评论,并鼓励贡献者在编辑后重新提交他们的 PR。开源领域工作中最有价值的部分就是协作,所以要设身处地的为他们着想,在处理 PR 过程中保持同理心。

写作时要清晰、周全

作为一个开源贡献者,你正在与社区交流,所以你的文章需要清晰且富有思想。即使你的母语是开发社区中使用的语言,也应该进行拼写和语法检查,以确保其清晰明了。特别是在处理技术概念的时候,当贡献的内容被拼写错误和糟糕的语法所混淆时,对于读者来说其理解难度直线上升。

这不仅关系到你的 PR 或期刊投稿,也关系到你的 README。拥有清晰、简洁、可操作的文档会很有帮助。

代码之外

有时候,热心的贡献者会一头扎进编码中,而忘记了开源项目还有其他领域需要贡献。

一个成功的项目除了代码之外,还包括许多方面,包括 UI/UX 设计、架构设计、文档、功能规划或公共路线图、测试和问题审查。在这些方面做出贡献,也能帮助你作为一个贡献者对项目整体有更好的理解。

如果要了解一个陌生项目的来龙去脉,没有比解决潜在问题更好的方法了。找一个项目的问题板块,给自己分配一些问题。这将让你很好地了解项目是如何运作的,并使你能够高屋建瓴,以便在今后贡献更好的代码。

贡献文档是另一个了解项目和它如何工作的方法。做好一份贡献文档需要你理解它,而理解它需要你和它一起工作。这是一个循环的过程,随着时间的推移,你会通过这个过程逐步增加你的贡献。

下一步

作为一个开源贡献者,有很多路选择。你不一定要成为一个开发者 “超级英雄” 才能成为一个项目的有价值的贡献者。许多成功的项目都是建立在日常开发者甚至是对工作充满热情的非开发者的贡献之上的。千里之行始于足下,你不需要在规划、开发、文档或测试等方面“成熟”后才能开始,从现在开始,朝着更好的方向努力进步即可。

相关文章推荐

发表评论