关于开源:如何开始参与开源社区

48次阅读

共计 1865 个字符,预计需要花费 5 分钟才能阅读完成。

本文作者:Daniel Hu
个人主页:https://www.danielhu.cn/


Note
来都来了,不看完整意思走?

TL;DR (本文精髓)

哥们(姐们)你(们)好!既然你开始寻找“如何参加 DevStream 社区”,那么我假设你曾经晓得 DevStream 我的项目的 org 地址和主库地址了。

“如果不晓得呢?” 如果你这样问我。

“好,我会再说一次” 我会这样通知你。

  • Org:https://github.com/devstream-io
  • Repo:https://github.com/devstream-…

不论是 org 主页还是 repo 里的 README,你都能够找到咱们的 Slack 频道或者 微信群二维码,请进入组织,而后找到“Daniel Hu”,群里艾特我,发送一条音讯:“我想参加社区”。完结。

“完结了?” 可能你又会问。

“完结了。” 我想通知你。

对,就是这么简略,你带着一颗心来,剩下的就都不是事了,我会手把手教你。(手把手,不是物理上的接触哈,尤其是男同胞们请留神。)

多说点?

好好好,我晓得你意犹未尽,那就再听我“胡扯”一些吧!

先申明一点,我不是权威,我也没有啥零碎的理论知识,单纯基于一些不成熟的教训,表白一些不成熟的想法,仅代表我集体。

第一步:理解我的项目

你开始筹备参加 DevStream 了,那么第一步你必定应该先尝试通过公开的材料理解 DevStream。有哪些材料呢?

  1. README(必读;如果你须要中文版,好吧,的确有,然而我倡议你读英文版。)
  2. Contribute 文档(必读;开始 Contribute 之前读一下 Contribute 文档不过分吧?;留神文末的 development 链接哦!)
  3. 其余文档(可选;你能够抉择感兴趣的内容浏览下。)
  4. 博客(可选;博客站点会轻松一些,如果你感兴趣并且有工夫,欢送浏览下咱们平时发的博文。)

第二步:寻找奉献点

  1. 最简略的形式当然是从咱们的 good first issue 开始。当然,很道歉,我能猜到很大概率你点开这个链接后看不到 issues 或者看不到适宜本人的 issues,因为太热门了,咱们来不及放足够的 good first issues 下来。
  2. 文档。没错,文档!文档无论何时都能够持续欠缺,文档不可能做到完满!(咱们的文档在主库的 docs 目录下,所以你的文档类型的奉献也会被合入主库,文档的奉献同样重要且可能看被看见,被认可!)
  3. 单元测试 /e2e 测试等。测试覆盖率永远不嫌高,如果关上咱们的代码库,你肯定能够找到须要欠缺测试用例的中央,大胆去加测试用例吧,这是咱们十分须要,不,十分急需的一块内容!没错,咱们十分欢送你来帮忙 DevStream 欠缺 UT/E2E,让 DevStream 更强壮!
  4. 代码里的 TODO。如果你开始刷源码(或者间接搜寻 todo),你肯定能够看到咱们留了很多的 TODO 在外面。选一个你感觉有必要实现的而且你 hold 得住的,提个 issue 通知咱们,而后咱们会把这个任务分配给你!
  5. bugfix/enhancement/… 祝贺你,如果从这一步开始,阐明你 xxxx(一堆褒义词)!关上 issues 列表,你总能找到奉献点,而后怯懦地留下你的评论,接着所有都会牵强附会!

第三步:提交你的奉献

如果你认真看了后面我列的“必读”资料,你必定曾经晓得开发工作流了。

不须要我赘述些什么,到这里你应该能顺利开始一个 pr,接下来的事件不会太简单。(如果你遇到了任何艰难,别害羞,给我发个微信音讯、邮件、GitHub 上间接艾特、…… 任何形式都行)

第四步:题目不重要,看内容

你都看到这一步了,反思一下,你进群了吗?加我微信了吗?README 和 Contribute 文档看了吗?issues 列表看了吗?少年,万事开头难,怯懦迈出第一步吧!回到前文,一步一步走!

“我都看了呀,你个 xx” 可能你会这样说。

“对不起对不起,大哥(姐),小弟口无遮拦,多有得罪,还望海涵!如果有啥不称心的中央,请提个 issue 通知我!” 我小声地通知你。


就说这么多,开始你的第一个 pr 吧,享受开源的乐趣!

如何参加 DevStream 社区?

欢送所有人参加社区建设,让 DevStream 越来越有生命力!

  • DevStream 代码仓库:https://github.com/devstream-…
  • DevStream 官网:https://www.devstream.io/
  • DevStream 文档:https://docs.devstream.io
  • 如何参加奉献:https://docs.devstream.io/en/…
  • DevStream 社群:退出 Slack
正文完
 0