为 Doris 做贡献
非常感谢您对 Doris 项目感兴趣,我们非常欢迎您对 Doris 项目的各种建议、意见(包括批评)、评论和贡献。
您对 Doris 的各种建议、意见、评论可以直接通过 GitHub 的 Issues (opens new window) 提出。
参与 Doris 项目并为其作出贡献的方法有很多:代码实现、测试编写、流程工具改进、文档完善等等。任何贡献我们都会非常欢迎,并将您加入贡献者列表,进一步,有了足够的贡献后,您还可以有机会成为 Apache 的 Committer,拥有 Apache 邮箱,并被收录到 Apache Committer 列表中 (opens new window)。
任何问题,您都可以联系我们得到及时解答,联系方式包括微信、Gitter(GitHub提供的即时聊天工具)、邮件等等。
初次接触
初次来到 Doris 社区,您可以:
- 关注 Doris Github 代码库 (opens new window)
- 订阅我们的 邮件列表;
- 加入 Doris 微信群(加微信号:morningman-cmy, 备注:加入Doris群) 随时提问;
- 进入 Doris 的 Gitter 聊天室;
通过以上方式及时了解 Doris 项目的开发动态并为您关注的话题发表意见。
Doris 的代码和文档
正如您在 [GitHub] (https://github.com/apache/incubator-doris) 上看到的,Apache Doris (incubating) 的代码库主要包括三部分:Frontend (FE), Backend (BE) 和 Broker (为了支持 HDFS 等外部存储系统上的文件读取)。文档主要是 Doris 网站和 GitHub 上的 wiki,还有运行 Doris 的时候的在线帮助手册。这些组件的详细情况参见下表:
组件名称 | 组件描述 | 相关语言 |
---|---|---|
Frontend daemon (FE) (opens new window) | 由“查询协调器”和“元数据管理器”组成 | Java |
Backend daemon (BE) (opens new window) | 负责存储数据和执行查询片段 | C++ |
Broker (opens new window) | 读取 HDFS 数据到 Doris | Java |
Website (opens new window) | Doris 网站 | Markdown |
GitHub Wiki (opens new window) | Doris GitHub Wiki | Markdown |
Doris 运行时 help 文档 | 运行 Doris 的时候的在线帮助手册 | Markdown |
改进文档
文档是您了解 Apache Doris 的最主要的方式,也是我们最需要帮助的地方!
浏览文档,可以加深您对 Doris 的了解,也可以帮助您理解 Doris 的功能和技术细节,如果您发现文档有问题,请及时联系我们;
如果您对改进文档的质量感兴趣,不论是修订一个页面的地址、更正一个链接、以及写一篇更优秀的入门文档,我们都非常欢迎!
我们的文档大多数是使用 markdown 格式编写的,您可以直接通过在 [GitHub] (https://github.com/apache/incubator-doris) 中的 docs/
中修改并提交文档变更。如果提交代码变更,可以参阅 Pull Request。
如果发现了一个 Bug 或问题
如果发现了一个 Bug 或问题,您可以直接通过 GitHub 的 Issues (opens new window) 提一个新的 Issue,我们会有人定期处理。
您也可以通过阅读分析代码自己修复(当然在这之前最好能和我们交流下,或许已经有人在修复同样的问题了),然后提交一个 Pull Request。
修改代码和提交PR(Pull Request)
您可以下载代码,编译安装,部署运行试一试(可以参考编译文档),看看是否与您预想的一样工作。如果有问题,您可以直接联系我们,提 Issue 或者通过阅读和分析源代码自己修复。
无论是修复 Bug 还是增加 Feature,我们都非常欢迎。如果您希望给 Doris 提交代码,您需要从 GitHub 上 fork 代码库至您的项目空间下,为您提交的代码创建一个新的分支,添加源项目为upstream,并提交PR。 提交PR的方式可以参考文档 Pull Request。