共计 3022 个字符，预计需要花费 8 分钟才能阅读完成。
ChunJun 是易用、稳固、高效的批流一体的数据集成框架，次要利用于大数据开发平台的数据同步 / 数据集成模块，使大数据开发人员可简洁、疾速的实现数据同步工作开发，供企业数据业务应用。
本文次要整顿 ChunJun 的各类链接以及如何提交 pr、Issue 的办法，心愿大家更好地参加开源，参加社区。
ChunJun 百科
● 开源地址
GitHub：https://github.com/DTStack/ch…
Gitee：https://gitee.com/dtstack_dev…
● 官方网站
https://dtstack.github.io/chu…
● 疾速入门文档
https://dtstack.github.io/chu…
● 视频课程
Flink StreamSQL 根底课程：
https://space.bilibili.com/67…
2021 年 ChunJun 课程：
https://space.bilibili.com/67…
2022 年 ChunJun 课程：
https://space.bilibili.com/67…
● 课件获取
关注公众号“ChunJun”，回复“课件”，即可取得您须要的对应课程的课件。
提交 pr&Issue 指南
如何提交一个优良的 pr
在 GitHub 上提交 pr 是参加 ChunJun 我的项目开源的一个重要途径，小伙伴们在应用中的一些性能上 feature 或者 bugfix 都能够向社区提交 pr 奉献代码，也能够依据已有的 Issue 提供本人的解决方案。
● 第一步：fork ChunJun 到本人的 GitHub 仓库
点击 fork 后就能够在本人仓库中看到以你名字命名的 ChunJun 我的项目了：
● 第二步：clone ChunJun 到本地 IDE
● 第三步：将 DTStack/ChunJun 设置为本地仓库的近程分支 upstream
● 第四步：提交代码
任何一个提交都要基于最新的分支 切换分支
本地批改代码后，提交 commit
commit_message 格局：commit_type message
commit_type:
feat：示意是一个新性能（feature)
hotfix：hotfix，修补 bug
docs：改变、减少文档
opt：批改代码格调及 opt imports 这些，不改变原有执行的代码
test：减少测试
eg:hotfix-12345 Fix mysql time type loses precision.
rebase 近程分支
这一步很重要，因为咱们仓库中的 chunjun 代码很有可能曾经落后于社区，所以咱们 push commit 前须要 rebase，保障咱们的 commit 是基于社区最新的代码，很多小伙伴没有这一步导致提交的 pr 当中蕴含了其他人的 commit
rebase 后有可能呈现代码抵触，个别是因为多人编辑同一个文件引起的，只须要依据提醒关上抵触文件对抵触局部进行批改，将提醒的抵触文件的抵触都解决后，执行
依此往返，直至屏幕呈现相似 rebase successful 字样即可
rebase 之后代码可能无奈失常推送，须要 git push -f 强制推送，强制推送是一个有危险的操作，操作前请仔细检查以避免出现无关代码被强制笼罩的问题
push 到 github 仓库
● 第五步：提交 pr
以我修复 kafka 写入过程中呈现空指针问题为例，通过步骤四我曾经把代码提交至我的仓库 master 分支
进入 ChunJun 仓库页面，点击 Pull Request
抉择 head 仓库和 base 仓库以及相应的分支
填写 pr 信息，pr 信息应该尽量概括分明问题的前因后果，如果存在对应 Issue 要附加 Issue 地址，保障问题是可追溯的
pr 提交胜利后须要一段时间代码 review，您能够急躁期待一下咱们 review 后合入，或者间接分割咱们，提交 pr 的同学更有机会退出咱们共创小组。
如何正确进行 pr review
● pr review
• 如果是简略的代码或者文档改变，review 完结能够间接合并
• 如果是较大的内容改变，须要对应模块 owner review
• 如果是性能分支，须要 pr 中提供设计思路，有必要的状况下，提供设计文档
• pr 回复工夫不能超过一周
• 不符合规范的 pr 在回复提醒过后仍未改变，不予合并，一周之后敞开
● review pr 的要求
• 在 pr 里备注修复的 issue
• pr commit 模版 hotfix-#issueID #fix-commit.
• 批改内容尽量放弃与 issue 内容统一，如果呈现无关批改，在 pr 中备注进去
• review 代码时留神代码格式化
如何正确提出一个 Issue
issue 是一种十分好的可积淀、可复现、可跟踪的交换形式，如果您发现了 ChunJun 有任何 bug 或奇怪的性能特色，请在 GitHub 或 Gitee 中提交新的 Issue。
目前咱们团队次要在 GitHub 上解决 Issue 和 pr 相干内容，Gitee 上会绝对慢一些，大家如果有 Issue 或者 pr 尽量在 GitHub 上提出，咱们会及时处理。
● 在 GitHub 上提交的新 Issue 分为以下几种：
• 反馈谬误 (Bug Reports)
• 提交新需要 (Feature Requests)
• 惯例问题 (General Questions)
• 性能问题 (Performance Questions)
● 进行高效发问的办法
请您详细描述存在问题 + 问题截图，提交到 ChunJun 的 Issue，以便咱们迅速定位问题并作出回应。
Issue 地址：
https://github.com/login?retu…
不理解如何高效进行发问的同学，请浏览上面两篇文章：
《发问的智慧》：
https://github.com/ryanhanwu/…
《社区发问指南》：
https://github.com/ryanhanwu/…
● 提交 Issue 须要留神的中央
提交的 Issue 最好带上具体的复现问题的步骤，这样能够缩小其余同步复现问题的工夫，更快更无效地解决问题。
如果能定位到源码的问题，倡议提交一个 pr 来修复它，而不是期待其他同学。
社群交换技巧
除了 GitHub 和 Gitee 之外，咱们还有一个领有 3000 多人的开源框架技术交换群，在群内，大家能够纵情交换 ChunJun 相干技术和资讯，各位开发者们互帮互助，一串代码、一个倡议，都是对 ChunJun 的莫大帮忙。
开源框架交换钉钉群号码：30537511
对于社群，咱们心愿它可能成为一个所有对开源、对 ChunJun 有趣味的敌人的交换场合，而不是一个单纯的答疑群。在群里，不论是 ChunJun 团队成员还是你们，所有人的角色都是 ChunJun 的爱好者和共建者，而不是“客服”“机器人”这样的角色。
当您对于 ChunJun 有疑难时，咱们首先举荐您搜寻相干文档，如果不能失去答案，强烈建议您通过提交 Issue 和咱们进行沟通，最初才是在社群内发问。因为通过提交 Issue 的形式，问题能够失去积淀，社群内音讯刷新得很快，一个不小心，您的问题就杳无音信了。
咱们团队成员平时还有本人的工作，没方法守在电脑前一个个回复社群中的问题，所以怯懦地提出 Issue 吧，那一刻，你就曾经变成了开源我的项目的参与者！
ChunJun 团队也将依据大家的反馈，定期更新迭代官网文档，不断完善我的项目品质，和你们一起共建 ChunJun。
袋鼠云开源框架钉钉技术交换 qun（30537511），欢送对大数据开源我的项目有趣味的同学退出交换最新技术信息，开源我的项目库地址：https://github.com/DTStack
