| @@ -0,0 +1,79 @@ | |||||
| # 项目贡献指南 | |||||
| 本项目协作采用标准的Pull Request(PR)流程机制,PR流程是开源项目协作和代码管理的核心机制。以下是创建和处理PR的详细步骤: | |||||
| ## 1. Fork项目仓库 | |||||
| - **目的**:将原始仓库复制到您的Gitee(或github)账户下,以便您可以进行修改。 | |||||
| - **步骤**: | |||||
| - 在Gitee(或github)上找到[GPUKernelContest](https://gitee.com/ccf-ai-infra/GPUKernelContest)。 | |||||
| - 点击页面右上角的“Fork”按钮,将该仓库复制到您的Gitee账户下。 | |||||
| ## 2. Clone项目仓库 | |||||
| - **目的**:将您Fork的项目仓库克隆到本地,以便在本地进行修改。 | |||||
| - **步骤**: | |||||
| - 在您的本地机器上,使用`git clone`命令将项目仓库Fork的仓库克隆到本地。 | |||||
| ```sh | |||||
| git clone https://gitee.com/ccf-ai-infra/GPUKernelContest.git | |||||
| ``` | |||||
| 备注:`giteeuseid替换您的url`。 | |||||
| ## 3. 创建新分支进行开发 | |||||
| - **目的**:在新的分支上进行修改,避免直接修改主分支。 | |||||
| - **步骤**: | |||||
| - 进入克隆的仓库目录。 | |||||
| ```sh | |||||
| cd GPUKernelContest | |||||
| ``` | |||||
| - 创建一个新的分支来(例如:`dev`分支)进行您的项目创作或者修订。 | |||||
| ```sh | |||||
| git checkout -b dev | |||||
| ``` | |||||
| ## 4. 进行修改 | |||||
| - **目的**:在您的新分支上`dev`进行项目创作或者修订。 | |||||
| - **步骤**: | |||||
| - 在您的`dev`分支上进行项目创作或者修订。 | |||||
| - 修改完成后,添加并提交您的更改。 | |||||
| ```sh | |||||
| git add . | |||||
| git commit -m "描述您的修改" | |||||
| ``` | |||||
| ## 5. 推送修改 | |||||
| - **目的**:将您的修改推送到您Fork的仓库。 | |||||
| - **步骤**: | |||||
| - 将您的修改推送到您Fork的仓库。 | |||||
| ```sh | |||||
| git push origin dev | |||||
| ``` | |||||
| ## 6. 创建Pull Request | |||||
| - **目的**:向原始仓库的维护者提交您的修改,请求合并。 | |||||
| - **步骤**: | |||||
| - 回到您的Gitee账户(或github),找到您Fork的仓库。 | |||||
| - 点击“New Pull Request”按钮。 | |||||
| - 选择您推送的分支和原始仓库的主分支进行比较。 | |||||
| - 填写PR的标题和描述,说明您的修改内容和目的。 | |||||
| - 点击“Create Pull Request”按钮,提交PR。 | |||||
| ## 7. 处理反馈 | |||||
| - **目的**:根据项目维护者的反馈进行必要的修改。 | |||||
| - **步骤**: | |||||
| - 项目维护团队或者维护者会审查您的PR,并可能提出修改意见或问题。 | |||||
| - 根据反馈进行必要的修改,并重复步骤4到步骤6,直到PR被接受。 | |||||
| ## 8. PR被合并 | |||||
| - **目的**:一旦您的PR被接受并合并到主分支,您的贡献就正式成为项目的一部分。 | |||||
| - **步骤**: | |||||
| - 项目维护者会合并您的PR。 | |||||
| - 您的修改现在成为原始仓库的一部分。 | |||||
| ## 9. 同步上游仓库 | |||||
| - **目的**:保持您的Fork仓库与上游仓库同步。 | |||||
| - **步骤**: | |||||
| - 为了保持您的Fork仓库与上游仓库同步,您需要定期从上游仓库拉取更新。 | |||||
| - 登录自己的Gitee账户(或github),找到您Fork的仓库。 | |||||
| - 点击`Sync fork`按钮同步最新的上游Fork的仓库。 | |||||
| 通过以上步骤,您就可以在Gitee(或github)上有效地参与项目的协作。希望这些信息对您有所帮助!如果有任何问题,随时欢迎提问。 | |||||