图1 开源数据库流行指数首次超过商业数据库

过去几年我一直在参与开源项目 Apache Doris 的推广工作，这一期间与许多开发者有过深度的探讨和交流。2022 年 6 月 Apache Doris 从 Apache 孵化器毕业正式成为 Apache 顶级项目，让 Apache Doris 在全球范围内受到了更多开发者的关注。在这一过程中也认识到，如何参与到开源项目的讨论和开发，是被许多开发者反复提及的问题，也是新人开发者最为迫切寻求解答的问题。

# 从 README 开始

图2 Apache Doris README 文档

邮件列表（Mailing List）是 Apache 社区最被认可的交流方式，无论是问题反馈与解答、技术交流与探讨、版本迭代与发布、社区决议与公示等，都可以通过邮件列表的形式来承载。邮件列表异步通信、理性思考、公开透明的特性，也非常适合开源社区的沟通交流，任何人都可以订阅邮件列表来知悉社区动态。订阅邮件列表操作可以参考以下链接：

与邮件列表这一异步沟通模式相对的，是以微信、QQ、钉钉等 IM 工具为代表的即时通讯模式。

由于信息传递的效率更高，即时通讯软件几乎成为国内开源社区日常技术沟通和交流的主要方式。以 Apache Doris 社区为例，目前 Apache Doris 社区有超过 20 个微信社群、聚集了超过 8000 人以上用户规模，相对于邮件列表，微信社群无疑承载了更多用户支持和问题解答的职责，每个用户都可以通过 Apache Doris 官网上的入口扫码加入用户社群中，去探讨技术和寻求答疑。

目前 Apache Doris 社区有一支专职的用户支持团队帮助社群中的用户定位和解决问题，尽管这能带来更好的用户体验（用一些社区用户的话说， Apache Doris 社区的技术支持力度甚至比一些商业软件的支持力度还要大），但微信社群天然存在的信息割裂、冗余信息过多、知识无法沉淀等弊端依然存在，因此社区也一直在寻求更加合理和可持续的方法，例如 Slack 社群以及 GitHub Discussion，希望在保持用户体验的同时也能提升沟通和解决问题的效率，这也是我们更为推荐的沟通方式。

# 善用官网和文档

官方网站和文档是深入了解一个开源项目最主要和高效的方式，熟读文档对于掌握开源项目的重要性不言而喻，在此也不再赘述。

图3 Apache Doris 官网首页

图4 Apache Doris 官网文档

参与开源项目并为其作出贡献的方法有很多，包括功能开发、测试 Case 编写、流程工具改进、文档完善、博客撰写等等，任何对于项目的贡献都是有价值并且受欢迎的。在提交的贡献正式合入后，将自动成为项目的贡献者并出现在项目的贡献者列表中。

Apache Doris 社区有着清晰的贡献者成长标准，贡献者在对项目有着足够的贡献后，有机会通过推选和投票成为 Committer，拥有代码库的合入权限，并且名字将出现在 Apache 网站列表中 。更进一步，还有机会成为项目的 PMC Member（项目管理委员会成员），对项目的重要决策拥有投票权。

Apache Doris PMC 名单：https://doris.apache.org/zh-CN/community/team

每一个贡献从最初的发起到最终的合入，大致会经历以下的步骤：

• 发现问题或优化项

• Fork 代码仓库

• 本地开发与自测

• 创建 Pull Request

• 等待 Code Review

• 审核通过并合入 Master

   寻找第一个贡献点

接下来聊聊如何寻找到一个贡献点，往往这也是大多数人跨入开源世界大门的第一步，有幸跨入的话则会发现门门外是两种完全不同的风景。

或许是在浏览文档时发现了一个小的错漏，例如发现一个小的错别字或者发现某个链接失效，又或许可能是已有的文档在细节描述或语义表达上有可提升的空间，可以把订正或补全开源文档作为第一个出发点，帮助文档质量得到提升，这也是参与开源项目的重要途径。

文档贡献：https://doris.apache.org/zh-CN/community/how-to-contribute/contribute-doc

也有可能是在使用开源项目过程中发现了一个 Bug ，或者应用其某一业务场景中发现还存在一些未被满足的功能点，经过阅读和分析代码后认为凭借自身能力可以对其进行改进，这时可以在 GitHub 上搜索是否有人与你具有相同的想法或问题，如果没有的话可以创建一个 Issue，并按照 Issue 模版依次补充相关信息。

图5 创建一个 Issue

同时在 Issue 列表中可以通过 Label 筛选出带有“good first issue” 的 Issue，通常是社区为新贡献者专门留出来的开发任务，并且在 Apache Doris 社区还会定期将新手任务汇总在置顶的 Issue 中。如果是第一次参与开源项目，可以选择这些简单任务进行练习，熟悉整个 Pull Request 提交流程之余还可以感受到社区对新人的友好度。

图6 Apache Doris Issue 列表

通常系统架构方面的修改或者重要的功能引入需要在社区进行充分的讨论与交流，可以在邮件组中发起讨论，也可以提交 Issue 发起，同时在 Doris Improvement Proposals 中提交详细的设计文档，帮助其他开发者了解功能的设计动机、需求与详细方案。

   Fork 代码仓库

git clone https://github.com/<your_github_name>/doris.git

cd  doris
git remote add upstream https://github.com/apache/doris.git

git remote -v
origin https://github.com/<your_github_name>/doris.git (fetch)
origin    https://github.com/<your_github_name>/doris.git (push)
upstream  https://github.com/apache/doris.git (fetch)
upstream  https://github.com/apache/doris.git (push)

4）新建分支以便在分支上做修改：

git checkout -b <your_branch_name>

1）提交代码到远程分支：

git commit -a -m "<you_commit_message>"
git push origin <your_branch_name

2）创建 Pull Request

最终通过 GitHub 检查任务以及 Code Reivew 的 Pull Request 会在一个工作日后被合入进 Master，至此恭喜成为 Apache Doris Contributor！