|
## 如何 Fork 项目?
|
|
# 如何参与并贡献?
|
|
|
|
|
|
|
|
在本课程项目中,你可以通过开源的方式来参与并贡献,包括反馈 Issue 或者是直接贡献内容。
|
|
|
|
|
|
|
|
关于如何创建 Issue 你可以参考 GitCode 关于 [Issue](https://gitcode.net/gitcode/help-docs/-/wikis/docs/user/project/issues/manage#create-a-new-issue) 的帮助文档
|
|
|
|
|
|
|
|
如果你选择直接贡献内容的话,你可以通过 Fork 项目的方式向课程仓库提交你的内容,具体贡献流程如下:
|
|
|
|
|
|
|
|
1. Fork 项目
|
|
|
|
2. 在 Fork 的项目中进行修改
|
|
|
|
3. 从 Fork 的项目中创建合并请求
|
|
|
|
4. 等待合并请求被合入
|
|
|
|
|
|
|
|
> 为什么是 Fork ?
|
|
|
|
>
|
|
|
|
> 当你尝试向一个你没有写入权限的项目中提交内容的时候,常见的做法是你可以 Fork 一个项目到自己的空间中,这样你不仅拥有一份与源项目一模一样内容的项目,同时你将还拥有完全的权限,可以对内容进行修改,并最终可以向源 Fork 项目进行变更请求(MR)的提交。
|
|
|
|
|
|
|
|
以下是各个步骤的详细说明和解释:
|
|
|
|
|
|
|
|
## Fork 项目
|
|
|
|
|
|
1. 在项目的右上角点击【Fork】按钮
|
|
1. 在项目的右上角点击【Fork】按钮
|
|
2. 选择 Fork 项目存放的地址,可以是你自己个人也可以是你有管理权限的组织
|
|
1. 选择 Fork 项目存放的地址,可以是你自己个人空间也可以是你有管理权限的组织/子组织空间中
|
|
|
|
|
|
|
|
![Fork 项目](./Images/fork.gif)
|
|
|
|
|
|
|
|
|
|
|
|
## 在 Fork 项目中工作
|
|
|
|
|
|
|
|
项目 Fork 完成后,你就拥有了对项目的完全编辑权限,你可以选择 Clone 到本地或者通过 WEBIDE(也可以使用 CSDN 的 WEBIDE)进行内容的编辑。
|
|
|
|
|
|
|
|
![WEBIDE](./Images/edit.gif)
|
|
|
|
|
|
|
|
点击了解 CSDN 的 WEBIDE >>> https://dev.csdn.net/page/ide
|
|
|
|
|
|
|
|
## 创建 MR
|
|
|
|
|
|
|
|
在完成内容的修改后,你就可以向源 Fork 项目进行内容的提交,创建合并请求的步骤如下:
|
|
|
|
|
|
|
|
1. 点击项目导航中的【合并请求】菜单
|
|
|
|
1. 点击【新建合并请求】按钮
|
|
|
|
1. 选择合并请求的源分支和目标分支
|
|
|
|
- 源分支,源分支是指当前你自己有过修改的分支,是这次合并请求发起的源分支
|
|
|
|
- 目标分支,目标分支是指你修改过内容要合入的分支,是这次合并请求完成后代码最终合入的分支
|
|
|
|
1. 点击【比较分支并继续】按钮
|
|
|
|
1. 填写合并请求的标题和描述,这些内容将用于告诉源项目成员你做的这些修改都包含什么,以便他们审查你的修改并合入你的修改
|
|
|
|
1. 点击【Submit 合并请求】按钮
|
|
|
|
1. 合并请求创建完成
|
|
|
|
|
|
|
|
到这个时候,你当前修改的内容就已经成功的通过合并请求(MR)的方式向源项目进行了提交,接下来等待源项目成员将你的修改合入即可。
|
|
|
|
|
|
|
|
![MR](./Images/mergerequest.gif) |
|
|
|
\ No newline at end of file |