Update joinus.png and PR process

Update joinus.png and PR process
pull/5180/head
Leif 2022-01-06 14:40:22 +08:00
parent 85ee484d71
commit a8300ea4b1
2 changed files with 42 additions and 31 deletions

View File

@ -153,7 +153,7 @@ cd PaddleOCR
> 多数情况下clone失败是由于网络原因请稍后重试或配置代理
#### 3.2.2 `远程仓库` 建立连接
#### 3.2.2 通过Token方式登录与建立连接
首先查看当前 `远程仓库` 的信息。
@ -163,7 +163,24 @@ git remote -v
# origin https://github.com/{your_name}/PaddleOCR.git (push)
```
只有clone的 `远程仓库` 的信息,也就是自己用户名下的 PaddleOCR接下来我们创建一个原始 PaddleOCR 仓库的远程主机,命名为 upstream。
只有clone的 `远程仓库` 的信息,也就是自己用户名下的 PaddleOCR。由于Github的登录方式变化需要通过Token的方式重新配置 `远程仓库` 的地址。生成Token的方式如下
1. 找到个人访问令牌token在Github页面右上角点击自己的头像然后依次选择 Settings --> Developer settings --> Personal access tokens
2. 点击 Generate new token在Note中填入token名称例如paddle。在Select scopes选择repo必选、admin:repo_hook、delete_repo等可根据自身需要勾选。然后点击Generate token生成token。最后复制生成的token。
删除原始的origin配置
```
git remote rm origin
```
将remote分支改成 `https://oauth2:{token}@github.com/{your_name}/PaddleOCR.git`。例如如果token值为12345你的用户名为PPOCR则运行下方命令
```
git remote add origin https://oauth2:12345@github.com/PPOCR/PaddleOCR.git
```
这样我们就与自己的 `远程仓库` 建立了连接。接下来我们创建一个原始 PaddleOCR 仓库的远程主机,命名为 upstream。
```
git remote add upstream https://github.com/PaddlePaddle/PaddleOCR.git
@ -172,8 +189,8 @@ git remote add upstream https://github.com/PaddlePaddle/PaddleOCR.git
使用 `git remote -v` 查看当前 `远程仓库` 的信息输出如下发现包括了origin和upstream 2个 `远程仓库`
```
origin https://github.com/{your_name}/PaddleOCR.git (fetch)
origin https://github.com/{your_name}/PaddleOCR.git (push)
origin https://oauth2:{token}@github.com/{your_name}/PaddleOCR.git (fetch)
origin https://oauth2:{token}@github.com/{your_name}/PaddleOCR.git (push)
upstream https://github.com/PaddlePaddle/PaddleOCR.git (fetch)
upstream https://github.com/PaddlePaddle/PaddleOCR.git (push)
```
@ -182,22 +199,23 @@ upstream https://github.com/PaddlePaddle/PaddleOCR.git (push)
#### 3.2.3 创建本地分支
可以基于当前分支创建新的本地分支,命令如下
首先获取 upstream 的最新代码,然后基于上游仓库 (upstream)的dygraph创建new_branch分支
```
git checkout -b new_branch
```
也可以基于远程或者上游的分支创建新的分支,命令如下。
```
# 基于用户远程仓库(origin)的dygraph创建new_branch分支
git checkout -b new_branch origin/dygraph
# 基于上游远程仓库(upstream)的dygraph创建new_branch分支
# 如果需要从upstream创建新的分支需要首先使用git fetch upstream获取上游代码
git fetch upstream
git checkout -b new_branch upstream/dygraph
```
> 如果对于新Fork的PaddleOCR项目用户远程仓库(origin)与上游(upstream)仓库的分支更新情况相同也可以基于origin仓库的默认分支或指定分支创建新的本地分支命令如下。
>
> ```
> # 基于用户远程仓库(origin)的dygraph创建new_branch分支
> git checkout -b new_branch origin/dygraph
>
> # 基于用户远程仓库(origin)的默认分支创建new_branch分支
> git checkout -b new_branch
> ```
最终会显示切换到新的分支,输出信息如下
```
@ -205,6 +223,8 @@ Branch new_branch set up to track remote branch develop from upstream.
Switched to a new branch 'new_branch'
```
切换分支之后即可在此分支上进行文件改动
#### 3.2.4 使用pre-commit勾子
Paddle 开发人员使用 pre-commit 工具来管理 Git 预提交钩子。 它可以帮助我们格式化源代码C++Python在提交commit前自动检查一些基本事宜如每个文件只有一个 EOLGit 中不要添加大文件等)。
@ -234,23 +254,15 @@ pre-commit
![img](../precommit_pass.png)
使用下面的命令完成提交。
提交修改,并写明修改内容("your commit info"
```
git commit -m "your commit info"
```
#### 3.2.6 保持本地仓库最新
#### 3.2.6 Push到远程仓库
获取 upstream 的最新代码并更新当前分支。这里的upstream来自于2.2节的`和远程仓库建立连接`部分。
```
git fetch upstream
# 如果是希望提交到其他分支则需要从upstream的其他分支pull代码这里是dygraph
git pull upstream dygraph
```
#### 3.2.7 push到远程仓库
使用push命令将修改的commit提交到 `远程仓库`
```
git push origin new_branch
@ -258,7 +270,7 @@ git push origin new_branch
#### 3.2.7 提交Pull Request
点击new pull request选择本地分支和目标分支如下图所示。在PR的描述说明中填写该PR所完成的功能。接下来等待review如果有需要修改的地方参照上述步骤更新 origin 中的对应分支即可。
打开自己的远程仓库界面选择提交的分支。点击new pull request或contribute进入PR界面。选择本地分支和目标分支如下图所示。在PR的描述说明中填写该PR所完成的功能。接下来等待review如果有需要修改的地方参照上述步骤更新 origin 中的对应分支即可。
![banner](../pr.png)
@ -285,8 +297,8 @@ git push origin new_branch
- 删除本地分支
```
# 切换到develop分支,否则无法删除当前分支
git checkout develop
# 切换到dygraph分支,否则无法删除当前分支
git checkout dygraph
# 删除new_branch分支
git branch -D new_branch
@ -310,7 +322,6 @@ git push origin new_branch
- 请注意每个commit的名称应能反映当前commit的内容不能太随意。
3如果解决了某个Issue的问题请在该Pull Request的第一个评论框中加上fix #issue_number这样当该Pull Request被合并后会自动关闭对应的Issue。关键词包括close, closes, closed, fix, fixes, fixed, resolve, resolves, resolved请选择合适的词汇。详细可参考[Closing issues via commit messages](https://help.github.com/articles/closing-issues-via-commit-messages)。
此外,在回复评审人意见时,请您遵守以下约定:

Binary file not shown.

Before

Width:  |  Height:  |  Size: 200 KiB

After

Width:  |  Height:  |  Size: 193 KiB