Browse Source

Merge pull request #1 from zhangjinnan:dev

add how to contribute.
pull/1/head
Kevin Zhang GitHub 3 months ago
parent
commit
2b2f90a051
No known key found for this signature in database GPG Key ID: B5690EEEBB952194
1 changed files with 79 additions and 0 deletions
  1. +79
    -0
      how-to-contribute.md

+ 79
- 0
how-to-contribute.md View File

@@ -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)上有效地参与项目的协作。希望这些信息对您有所帮助!如果有任何问题,随时欢迎提问。

Loading…
Cancel
Save