参与贡献
贡献workflow
1、从 fork 工程的 develop 分支 创建改动分支。
2、提交变更需要遵循 commit规范。
3、创建一个 pull request (PR) 指向develop分支,具体需要遵循PR规范。
4、大改动创建一个Issue,遵循Issue规范。
具体事项
commit规范
1、email 和 GitHub 的 email 一致
2、commit log 需要保持简练、规范,要求格式如下:
<type>: <description>
type 类型:
- test 增加缺失的测试
- feat 新功能
- fix 问题修复
- chore 构建过程或辅助工具更改
- docs 文档更改
description 描述:
- 总结性描述本次改动
PR规范
🌀NOTE:一个PR不要过大,按照功能拆分成独立PR。
1、提交变更
保持fork的工程代码内容最新
fork工程的分支需要和github主仓库保持一致:
多个commit合并成一个
- 应保持有效commit数量,merge --squash 仅保留一个commit
- commit信息应能反映当前 commit 的内容,不能随意描述: 查看 commit规范
git merge --squash feature/xxx --allow-unrelated-histories
git commit -m 'feat: xxxxx'
2、创建PR
指定到主repo的develop分支
PR描述规范
Title: 功能/优化格式:
[Feature]: xxx
bug修复格式:
[Fix]: xxx
Description: 详细列出修改点,若有需要补充截图
改动原因:// 为什么要改
改动内容:// 详细描述改了什么
改动验证:// 怎么验证的
Issue:// issue链接
测试要求
(待补充)
常见问题
签署CLA
在首次向 didi/xiaoju-survey 提交 Pull Request 时,会提示需要签署,以保证你的代码可以被合入。
1、查看 Pull Request 中的 Check 部分,找到 license/cla,并点击右侧 Details,进入 CLA 网站:
2、请阅读协议内容后单击 Sign in with GitHub to agree,页面将跳转回 Pull Request 页面。