只有贡献代码才算是参与开源项目社区贡献吗?
一说到参与开源项目贡献,一般大家的反应都是代码级别的贡献,总觉得我的代码被社区合并了,我才算一个贡献者,这是一个常见的错误认知。其实,在一个开源社区中有非常多的角色是 non-code contributor,一个开源社区中的很多关键职责被大家给忽略了。
组织活动也可以是贡献社区:
-
你可以像远在巴西库亚巴的 @fzamperin 学习,为你喜欢的开源项目组织 workshop 或线下 meetup
-
你还可以帮助社区成员找到合适的线下峰会来提交技术议题
-
……
技术写作或者技术布道也是贡献社区:
-
为你喜欢的开源项目编写或者改进文档
-
建立一个如何使用这个开源项目的 samples
-
将文档翻译成其他语言,帮助全球开发者认识、使用该项目
-
在自己的公众号或者博客分享使用该项目的指南和心得
-
……
设计和官网开发也是贡献社区:
-
重构开源项目官网来帮助开发者更好的认识、使用该开源项目
-
进行用户调研来更好地改善官网导航和目录
-
构建一个 style guide 来帮助该项目拥有一个更统一、完善的视觉设计
-
为该开源项目设计贴纸、T 恤等周边
-
……
Apache Dubbo Samples SIG 成立!samples 贡献者招募中
Apache Dubbo 发展到今天,已经有 386 个贡献者,贡献者了包括代码、测试、用例、文档、使用建议等丰富内容。当前 Dubbo Core 有 2.7、3.0 两个非常活跃的演进分支,其中 2.7 版本已被众多知名企业大规模的投入生产环境,如携程、工商银行、瓜子二手车等,而 3.0 分支也已经在 3 月份发布了 preview 版本,按照计划在 6 月份第一个 3.0 可用版本也将正式发布。
内核的快速演进与迭代促进了 Dubbo 的快速发展,同时,也给整个社区与 Committer 核心项目组带来新的挑战,这体现在:
-
新 Feature 相关的用户示例与文档缺失。用户对新版本特性如何使用无从知晓,翻阅代码成为唯一的途径。
-
稳定性无法得到充分保障。在迭代过程中,单元测试、集成测试没有得到有效的补充,这导致测试覆盖度的下降和回归成本的高涨,更糟糕的是如果发版环节有些问题仍未被发现,则它们将不可避免的被带到用户使用环节。
由于文档和用例的缺失,我们不得不处理大量的 Issue、也包括其他的线上答疑,来解答用户的疑问,其中有一些是用户不知道某个具体功能怎么用,有一些则是使用了不正确的配置方式导致不能正常运行;稳定性的下降则是对我们自己以及 Dubbo 用户两方面的双重打击,持续的出现问题会导致用户开始对 Dubbo 的版本发布失去信心,而对我们这些核心维护者而言,花费大量精力完成的版本却给用户带来了困扰,这会让整个开发组也变得沮丧。毫无疑问,对于 Dubbo 社区而言,解决以上问题成为了当前迫在眉睫的工作任务,这本身的重要性并不亚于大家所热衷的核心功能开发,但我们也认识到,投入到其中需要花费一定的精力,仅仅靠当前的几位维护者会非常吃力,尤其是考虑到他们还需要兼顾整个 Dubbo 社区的运作。
在这样的背景下,我们想到了召集来自社区的力量,今天在 Committer 核心成员的一致建议下,Apache Dubbo 决定成立 Samples SIG(注:SIG 是 special interest group 的缩写,即兴趣小组),以期能改善以上的示例缺失、稳定性等问题。毫无疑问,这个 SIG 的运转需要广大开发者的积极参与,当然,社区的核心开发者们也会积极的活跃在其中。
Dubbo 现状
当然,能稳定的支撑这么多企业与实例稳定的运行,Dubbo 的测试与稳定性机制也并非一无是处,以下是 Dubbo 具备的一些能力与运作机制。
-
单元测试。单元测试全部位于 https://github.com/apache/dubbo 主干仓库,目前能达到大概 40% - 50% 的覆盖度,但遗憾的是近期的很多新增修改,包括 2.7 与 3.0,在这方面做的都有所欠缺。
-
集成测试。Dubbo 的集成测试项目位于 https://github.com/apache/dubbo-samples,里面包含了我们当前建设的大部分 Dubbo Feature 用例,你可以把当做一个Quick Start的示例工程用,也可以作为功能参考手册(代码),我们在其上构建了自动化的集成测试机制,能实现对所有用例的全量验证。
-
基于 Github Actions 的自动化测试流程。每一次代码提交、PR 都会触发这个 Workflow,它会对主干仓库进行编译,并依次运行单元测试、集成测试,同时还有一些代码合规范的检查。
我们要做的提升计划,就是在以上已有组件的基础之上继续完善。通过梳理,我们总结出以下部分内容需要重点完善:
-
Dubbo 3.0 中新引入的一些核心机制、组件的单元测试覆盖
-
Dubbo 3.0 中新引入的一些核心组件的用户用例、集成测试
-
Dubbo 重点组件的,如 Zookeeper、Nacos 等
-
Dubbo 内核一些核心组件,如 Registry、Directory、URL、FilterBuilder、Context、AsyncRpcResult、ApplicationModel、ServiceRepository 等的单元测试覆盖
请关注下文的 SIG 联系方式,以实现更好的持续协作和任务进度的更新。
对参与者的帮助与要求
参与到 SIG 中来,不论你是学生、初学 Dubbo 的开发者、用户、或是混迹职场的技术达人,这里应该都能您带来一些帮助:
-
掌握 Dubbo 新特性的使用方式
-
快速了解 Dubbo 的核心工作机制
-
掌握 Dubbo 的演进动态的一手信息
-
如果你是企业用户,也能共同实现推动 Dubbo 稳定性的提升,解决 Dubbo 的企业落地问题
-
与业内的技术专家、同行深入交流,提升自己,实现信息共享
-
积累活跃度,成为开源达人,与 Apache 结缘并有机会成为 Apache Dubbo Committer
另外,社区也会不定期的举办线上、线下活动,获得社区贡献者专属礼物。
我们对参与者的唯一要求就是热情,希望参与者能持续的投入在 Dubbo 社区的建设中,并定期的参加我们 SIG 的交流活动,以实现与其他人的协作。
如何成为 Apache Dubbo Samples SIG 贡献者?
如果你对参与到 Dubbo 社区贡献有兴趣,想加入 Apache Dubbo Samples SIG,欢迎扫描二维码加入Dubbo Samles SIG。
钉钉扫描二维码进群
猜你喜欢: