頭圖來源：https://opensource.guide/
來源 | 阿里巴巴云原生公眾號
?

只有貢獻代碼才算是參與開源項目社區貢獻嗎？

一說到參與開源項目貢獻，一般大家的反應都是代碼級別的貢獻，總覺得我的代碼被社區合并了，我才算一個貢獻者，這是一個常見的錯誤認知。其實，在一個開源社區中有非常多的角色是 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 的交流活動，以實現與其他人的協作。

參考文檔：

• https://opensource.guide/how-to-contribute/

總結

以上是生活随笔為你收集整理的参与 Apache 顶级开源项目的 N 种方式，Apache Dubbo Samples SIG 成立！的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。