关于开源那些事儿(1-2)

关于如何做一名优秀的开源贡献者,GitHub 官方发布过一篇指南《How to Contribute to Open Source》,它会给每一个新注册的用户推送这篇文章。以下内容就参考该文章,简单阐述为什么要参与开源,为什么要读源码,为什么有人热衷于读源码等一系列问题。

上一篇文章说了为什么要参与开源项目,这一篇文章讲一下在参与开源项目的时候需要注意哪些内容。

首先,什么是开源项目。

开源项目更像是人类在计算机上面构建的巴别塔。所有人都可以参与到一个项目中去,所有人都可以利用自己的专业技能推动开源项目的发展,不论是开发者,设计师还是产品经理,甚至一名学生都能通过自己的职业技能和组织能力,来参与到开源项目中去,帮助开源项目得到更好的发展。

在参与开源项目的过程中需要注意什么呢?

1:一个完整的开源项目,都需要具备以下部分。

参与者:包括作者,拥有者,维护人员,贡献者,社区成员。

文档:许可证,README,流程文档,行为准则,技术文档,基础教程。

协作方式:发起 issue,提交 PR,社区讨论,实时沟通。

2:在参与开源项目时,先正视自己。

要参与到开源,就必须成为那个能发现或解决问题的人,找到你感兴趣的项目,从小事做起,修复文档的无效连接和错别字是参与开源,发现问题并详述,能复现问题也是参与开源。

3:在参与项目中需要注意的问题

 

  • 给定上下文,最好说明问题的前因后果,最忌讳没头没尾的一句“功能不能用”,“项目有问题”等等。
  • 提前做好相关的准备工作
  • 提前阅读相关文档与资料,对于没有看文档和资料导致操作报错的问题,其他项目成员一般也不会理会。
  • 说话简明扼要
  • 尽量让沟通信息公开透明
  • 提问时请保持耐心
  • 尊重社区的决定
  • 最重要的是,保持高雅

4:在参与文档之后可能遇到的问题

1)没有得到任何反馈

首先,确保你提前核对过项目的各种情况。

如果一切都正常,可在一周后尝试联系项目相关人员,询问具体情况。联系的时候,请尽量不要使用私人渠道联系项目维护人员,因为开源的同时也意味着所有信息要尽量保持公开透明。

当然,作者有在项目中提供自己的联系方式除外,但私下沟通的所有与项目相关的信息,最好保留一份上传到该问题相关的讨论帖上。

比较糟糕的情况是,提交的贡献一直没有得到反馈。如果是这样,也请你不要灰心,生活总有一些不可控的事情发生,你要做的,是接着寻找下一个项目,调整心态,重新来过。

2)有人更改了你的贡献

在你得到相关通知后,出于礼貌与高效沟通,请及时给出反馈。因为他人可能花了不少时间来审核你的问题 / 代码,然后发起的更改提交。

如果你没有时间处理他人提交的更改,也请提前告知提交者与项目维护人员,找到一个可以接手并处理该问题的人。

3)你的贡献未被接受

这种情况很正常,一般作者也都会说明未被接受的具体原因。如果没有,可以在项目的相关讨论帖下询问作者具体原因。但无论如何,请尊重作者的决定,不要开撕。实在不行,你也可以 fork 一份代码自己玩。

4)你的贡献被接受了

恭喜你,你作出的贡献真真切切帮到了其他人。希望后面接着坚持,请记住,千里之行始于足下。

 

————————————————————————————————————–

以上部分内容来自:GitHubDaily 感谢他为社区做出的贡献。

下一篇:在参与开源的过程中如何正确提问?

本文来自投稿,不代表微擎百科立场,如若转载,请注明出处:https://www.w7.wiki/code/2320.html

发表评论

登录后才能评论