为 Doris 做贡献

非常感谢您对 Doris 项目感兴趣,我们非常欢迎您对 Doris 项目的各种建议、意见(包括批评)、评论和贡献。

您对 Doris 的各种建议、意见、评论可以直接通过 GitHub 的 Issues为 Doris 做贡献 - 图1 (opens new window) 提出。

参与 Doris 项目并为其作出贡献的方法有很多:代码实现、测试编写、流程工具改进、文档完善等等。任何贡献我们都会非常欢迎,并将您加入贡献者列表,进一步,有了足够的贡献后,您还可以有机会成为 Apache 的 Committer,拥有 Apache 邮箱,并被收录到 Apache Committer 列表中为 Doris 做贡献 - 图2 (opens new window)

任何问题,您都可以联系我们得到及时解答,联系方式包括微信、Gitter(GitHub提供的即时聊天工具)、邮件等等。

初次接触

初次来到 Doris 社区,您可以:

通过以上方式及时了解 Doris 项目的开发动态并为您关注的话题发表意见。

Doris 的代码和文档

正如您在 GitHub为 Doris 做贡献 - 图4 (opens new window) 上看到的,Apache Doris (incubating) 的代码库主要包括三部分:Frontend (FE), Backend (BE) 和 Broker (为了支持 HDFS 等外部存储系统上的文件读取)。文档主要是 Doris 网站和 GitHub 上的 wiki,还有运行 Doris 的时候的在线帮助手册。这些组件的详细情况参见下表:

组件名称组件描述相关语言
Frontend daemon (FE)为 Doris 做贡献 - 图5 (opens new window)由“查询协调器”和“元数据管理器”组成Java
Backend daemon (BE)为 Doris 做贡献 - 图6 (opens new window)负责存储数据和执行查询片段C++
Broker为 Doris 做贡献 - 图7 (opens new window)读取 HDFS 数据到 DorisJava
Website为 Doris 做贡献 - 图8 (opens new window)Doris 网站Markdown
GitHub Wiki为 Doris 做贡献 - 图9 (opens new window)Doris GitHub WikiMarkdown
Doris 运行时 help 文档运行 Doris 的时候的在线帮助手册Markdown

改进文档

文档是您了解 Apache Doris 的最主要的方式,也是我们最需要帮助的地方!

浏览文档,可以加深您对 Doris 的了解,也可以帮助您理解 Doris 的功能和技术细节,如果您发现文档有问题,请及时联系我们;

如果您对改进文档的质量感兴趣,不论是修订一个页面的地址、更正一个链接、以及写一篇更优秀的入门文档,我们都非常欢迎!

我们的文档大多数是使用 markdown 格式编写的,您可以直接通过在 GitHub为 Doris 做贡献 - 图10 (opens new window) 中的 docs/ 中修改并提交文档变更。如果提交代码变更,可以参阅 Pull Request

如果发现了一个 Bug 或问题

如果发现了一个 Bug 或问题,您可以直接通过 GitHub 的 Issues为 Doris 做贡献 - 图11 (opens new window) 提一个新的 Issue,我们会有人定期处理。

您也可以通过阅读分析代码自己修复(当然在这之前最好能和我们交流下,或许已经有人在修复同样的问题了),然后提交一个 Pull Request

修改代码和提交PR(Pull Request)

您可以下载代码,编译安装,部署运行试一试(可以参考编译文档),看看是否与您预想的一样工作。如果有问题,您可以直接联系我们,提 Issue 或者通过阅读和分析源代码自己修复。

无论是修复 Bug 还是增加 Feature,我们都非常欢迎。如果您希望给 Doris 提交代码,您需要从 GitHub 上 fork 代码库至您的项目空间下,为您提交的代码创建一个新的分支,添加源项目为upstream,并提交PR。 提交PR的方式可以参考文档 Pull Request