qiaojialin opened a new issue #1995:
URL: https://github.com/apache/iotdb/issues/1995


   ## 联系我们
   
   在使用IoTDB的过程中,如果您发现任何问题,有任何新的想法、建议都可以通过Apache邮件列表、QQ群或者微信群参与到IoTDB的社区建设中。
   
   ### QQ群
   
   * Apache IoTDB交流群:659990460
   
   ### 微信群
   
   * 添加好友 tietouqiao,我们会邀请您进群。
   
   ### 公众号:IoTDB漫游指南
   
   * 不定期发布IoTDB相关消息。微信搜索Apache-IoTDB,或扫描下方二维码即可关注我们。
   
   ### 订阅邮件列表
   
    * 
发送订阅邮件。使用想接收邮件的邮箱向[[email protected]](mailto:[email protected])
 发送一封邮件,主题内容不限。
    * 确认订阅邮件。完成上一步后,您将收到一封来自iotdb.apache.org结尾的确认订阅邮件。向该邮件再次发一封主题内容不限的邮件即可确认订阅。
    * 
至此,您可以通过订阅的邮箱接收及回复邮件,或通过查看[归档邮件](https://lists.apache.org/[email protected])来跟踪之前的邮件对话。
   
   如果您正在使用IoTDB,欢迎联系我们,请在这个[调研问卷](https://github.com/apache/iotdb/issues/748) 
分享您使用IoTDB的经验,非常期待您的参与。
   
   ## 贡献指南
   
   ### 提交issue
   
   
如果您有任何希望IoTDB支持的新功能、期望IoTDB的改进提升或者发现了bug,欢迎您在[Jira](https://issues.apache.org/jira/projects/IOTDB/issues)
 或着[Github](https://github.com/apache/iotdb/issues)上提issue。
   
   * 在提交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: 开发指南-中文版
   
   官网用户手册版本和分支的对应关系:
   
   * In progress -> master
   * major_version.x -> rel/major_version (如 0.10.x -> rel/0.10)
   
   注意事项:
   
   * Markdown 中的图片可上传至 
[https://github.com/thulab/iotdb/issues/543](https://github.com/thulab/iotdb/issues/543)
 获得 url
   
   ### 贡献代码
   
   可以到 jira 上领取现有 issue 或者自己创建 issue 再领取,评论说我要做这个 issue 就可以。
   
   * 从iotdb的仓库上fork一个分支到您自己的仓库来开始工作,clone到本地并设置upstream为shardingsphere的repo。
   
   ```
   git clone https://github.com/自己的仓库/iotdb.git
   git remote add upstream https://github.com/apache/iotdb.git
   ```
   
   * 进入 iotdb 根目录,拉取最新 master 分支,从 master 切出新的分支,分支名根据这个分支的功能决定,一般叫 
f_new_feature(如f_storage_engine) 或者 fix_bug(如fix_query_cache_bug)
   
   ```
   cd iotdb
   git pull upstream master
   git checkout -b "f_storage_engine"
   ```
   
   * 在 idea 中添加 code style 为 根目录的 java-google-style.xml
   * 修改代码,增加测试用例(单元测试、集成测试)
     * 集成测试参考: 
server/src/test/java/org/apache/iotdb/db/integration/IoTDBTimeZoneIT
   * 提交 PR, 以 [IOTDB-jira号] 开头
   
   ```
   git add 修改代码
   git commit -m 'commit log'
   git push origin f_storage_engine
   ```
   
   * 发邮件到 dev 邮件列表:(I've submitted a PR for issue IOTDB-xxx [link])
   * 根据其他人的审阅意见进行修改,继续更新,直到合并
   * 关闭 jira 或Github issue
   
   注意: 为了让您的 id 显示在 contributor 列表中,别忘了以下设置:
   
   ```
   git config --global user.name "username"
   git config --global user.email "[email protected]"
   ```
   
   


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
[email protected]


Reply via email to