开发流程
按照以下步骤参与项目开发。
与上游仓库同步
如果你之前 fork 了该仓库,请与上游仓库的变更保持同步:
git checkout dev # 切换到 dev 分支
git fetch upstream # 获取上游仓库的最新更改
git pull upstream dev # 将更改合并到本地 dev 分支
git push origin dev # 将合并后的代码推送到你自己的 fork
创建功能分支
为你的新功能或修订创建一个新的分支:
git checkout -b feat/descriptive-name
添加你的功能或修订
在相应文件中实现你的功能、修订或改进。
- 例如,你可以在
src/memos/hello_world.py
中添加一个函数,并在tests/test_hello_world.py
中编写相应的测试用例。
测试你的更改
运行测试套件以确保更改正确:
make test
提交更改
提交更改时请遵循项目的提交规范(参见 提交规范)。
推送到你的 Fork 仓库
将功能分支推送到你 fork 的远程仓库:
git push origin feat/descriptive-name
创建 Pull Request
提交你的更改以供审核:
- 重要提示: 请务必将 Pull Request 提交到:
- ✅ 上游仓库的
dev
分支, - ❎ 而不是上游仓库的
main
分支。
- ✅ 上游仓库的
- 打开 GitHub 上的原始仓库
- 点击 "Pull Requests"
- 点击 "New Pull Request"
- 选择
dev
作为目标分支,你的分支作为对比分支 - 仔细填写 PR 描述