-->
2. 联系我们

在使用 IoTDB 的过程中,如果您发现任何问题、有任何新的想法,可以通过 Apache 邮件列表、QQ 群、微信群参与到 IoTDB 的社区建设中。

订阅邮件列表

发送订阅邮件。使用想接收邮件的邮箱向 dev-subscribe@iotdb.apache.org 发送一封邮件,主题内容不限。
确认订阅邮件。完成上一步后,您将收到一封来自 iotdb.apache.org 结尾的确认订阅邮件。向该邮件再次发一封主题内容不限的邮件即可确认订阅。
至此,您可以通过订阅的邮箱接收及回复邮件,或通过查看 归档邮件 来跟踪之前的邮件对话。

QQ群

Apache IoTDB 交流群:659990460

微信群

添加好友 qinchuqing或tietouqiao,我们会邀请您进群。

公众号:Apache IoTDB

公众号内容:包括 IoTDB 的使用教程、源码解析、实际案例、社区活动等,欢迎投稿!

关注方式:微信搜索 Apache-IoTDB,或扫描下方二维码即可关注我们。



案例分享

如果您正在使用 IoTDB,欢迎在这个 调研问卷 分享您使用 IoTDB 的经验,非常期待您的参与。

3. 贡献指南
提交 Jira issue

如果您有任何希望 IoTDB 支持的新功能、期望 IoTDB 的改进提升或者发现了 bug,欢迎您在 Jira 或着 Github 上提 issue。

●  在提交 issue 之前,请先查看 issue 列表或简单搜索,确定该 issue 不重复。
●  新建一个 issue 并选择您的 issue 类型。
●  使用一个清晰并有描述性的标题来定义 issue。
●  根据模板填写必要信息。
●  在提交 issue 之后,对该 issue 分配合适的标签。如:Wish,Improvement,Bug 等。
●  请对自己提交的 issue 保持关注,在讨论中进一步提供必要信息。

邮件讨论(英文)

●  如果您第一次参与邮件列表可以简单介绍一下自己。
●  开发功能前可以发邮件声明一下自己想做的任务。
●  设计文档讨论

贡献文档

IoTDB 所有官网上的内容都在项目根目录的 docs 中:

●  docs/SystemDesign: 系统设计文档-英文版
●  docs/zh/SystemDesign: 系统设计文档-中文版
●  docs/UserGuide: 用户手册-英文版
●  docs/zh/UserGuide: 用户手册-中文版
●  docs/Community: 社区-英文版
●  docs/zh/Community: 社区-中文版
●  docs/Development: 开发指南-英文版
●  docs/zh/Development: 开发指南-中文版

官网用户手册版本和分支的对应关系:

●  latest -> master
●  major_version.x -> rel/major_version (如 0.10.x -> rel/0.10)

注意事项:

●  Markdown 中的图片可上传至 thulab/iotdb#543 获得 url

贡献代码

可以到 jira 上领取现有 issue 或者自己创建 issue 再领取,评论说我要做这个 issue 就可以。

●  从 iotdb 的仓库上 fork 一个分支到您自己的仓库来开始工作,clone 到本地并设置 upstream 为 apache/iotdb 的仓库。

 

●  进入 iotdb 根目录,拉取最新 master 分支,从 master 切出新的分支,分支名根据这个分支的功能决定,一般叫 f_new_feature(如f_storage_engine) 或者 fix_bug(如fix_query_cache_bug)

●  在 idea 中添加 code style 为 根目录的 java-google-style.xml
●  修改代码,增加测试用例(单元测试、集成测试)
●  集成测试参考: server/src/test/java/org/apache/iotdb/db/integration/IoTDBTimeZoneIT
●  提交 PR, 以 [IOTDB-jira号] 或者[ISSUE-github issue号]开头

●  发邮件到 dev 邮件列表:(I've submitted a PR for issue IOTDB-xxx [link])
●  根据其他人的审阅意见进行修改,继续更新,直到合并
●  关闭 jira 或 Github issue

注意: 为了让您的 id 显示在 contributor 列表中,别忘了以下设置:

扫码关注

关注我们

联系我们

Contact Us

* 为必填信息