[Docs] Modify contributing.md ()

* add_git_introduce

* add en_contributing

* edit picture

* fix
pull/559/head
LinXiaoZheng 2023-02-28 16:19:59 +08:00 committed by GitHub
parent a321cfae80
commit 28b6a88fe7
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 108 additions and 0 deletions
docs
en/recommended_topics
zh_cn/recommended_topics

View File

@ -21,6 +21,60 @@ The steps to fix the bug of code implementation are as follows.
You can directly post a pull request to fix documents. If you want to add a document, you should first create an issue to check if it is reasonable.
## Preparation
The commands for processing pull requests are implemented using Git, and this chapter details `Git Configuration` and `associated GitHub`.
### 1. Git Configuration
First, make sure you have Git installed on your computer. For Linux systems and macOS systems, Git is generally installed by default. If it is not installed, it can be downloaded at [Git-Downloads](https://git-scm.com/downloads).
```shell
# view the Git version
git --version
```
Second, check your `Git Config`
```shell
# view the Git config
git config --global --list
```
If `user.name` and `user.email` are empty, run the command.
```shell
git config --global user.name "Change your username here"
git config --global user.email "Change your useremail here"
```
Finally, run the command in `git bash` or `terminal` to generate the key file. After the generation is successful, a `.ssh` file will appear in the user directory, and `id_rsa.pub` is the public key file.
```shell
# useremail is GitHub's email address
ssh-keygen -t rsa -C "useremail"
```
### 2. Associated GitHub
First, open `id_rsa.pub` and copy the entire contents.
Second, log in to your GitHub account to set it up.
<img src="https://user-images.githubusercontent.com/90811472/221778382-a075167d-b028-4f68-a1c7-49a8f6f3d97b.png" width="1200">
Click `New SSH key` to add a new SSH keys, and paste the copied content into Key.
<img src="https://user-images.githubusercontent.com/90811472/221577720-af5536b3-47ba-48bc-adcc-c2b83f22081d.png" width="1200">
Finally, verify that SSH matches the GitHub account by running the command in `git bash` or `terminal`. If it matches, enter `yes` to succeed.
```shell
ssh -T git@github.com
```
<img src="https://user-images.githubusercontent.com/90811472/221573637-30e5d04d-955c-4c8f-86ab-ed6608644fc8.png" width="1200">
## Pull Request Workflow
If you're not familiar with Pull Request, don't worry! The following guidance will tell you how to create a Pull Request step by step. If you want to dive into the development mode of Pull Request, you can refer to the [official documents](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/about-pull-requests)

View File

@ -23,6 +23,60 @@
1. 提交 issue确认添加文档的必要性。
2. 添加文档,提交拉取请求。
## 准备工作
拉取请求工作的命令都是用 Git 去实现的,该章节详细描述 `Git 配置` 以及与 `GitHub 绑定`
### 1. Git 配置
首先,确认电脑是否安装了 Git。Linux 系统和 macOS 系统,一般默认安装 Git如未安装可在 [Git-Downloads](https://git-scm.com/downloads) 下载。
```shell
# 在命令提示符cmd或终端下输入以下命令查看 Git 版本
git --version
```
其次,检测自己 `Git Config` 是否配置
```shell
# 在命令提示符cmd或终端下输入以下命令查看 Git Config 是否配置
git config --global --list
```
`user.name``user.email` 为空,则输入以下命令进行配置。
```shell
git config --global user.name "这里换上你的用户名"
git config --global user.email "这里换上你的邮箱"
```
最后,在 `git bash` 或者 `终端` 中,输入以下命令生成密钥文件。生成成功后,会在用户目录下出现 `.ssh` 文件,其中 `id_rsa.pub` 是公钥文件。
```shell
# useremail 是 GitHub 的邮箱
ssh-keygen -t rsa -C "useremail"
```
### 2. GitHub 绑定
首先,用记事本打开 `id_rsa.pub` 公钥文件,并复制里面全部内容。
其次,登录 GitHub 账户找到下图位置进行设置。
<img src="https://user-images.githubusercontent.com/90811472/221778382-a075167d-b028-4f68-a1c7-49a8f6f3d97b.png" width="1200">
点击 `New SSH key` 新增一个 SSH keys将刚才复制的内容粘贴到下图所示的 Key 中Title 可以写设备名称,最后确认即可。
<img src="https://user-images.githubusercontent.com/90811472/221549754-53670c19-5efe-48b2-9ac5-bafb43891903.png" width="1200">
最后,在 `git bash` 或者 `终端` 中输入以下命令,验证 SSH 是否与 GitHub 账户匹配。如果匹配,输入 `yes` 就成功啦~
```shell
ssh -T git@github.com
```
<img src="https://user-images.githubusercontent.com/90811472/221573637-30e5d04d-955c-4c8f-86ab-ed6608644fc8.png" width="1200">
## 拉取请求工作流
如果你对拉取请求不了解,没关系,接下来的内容将会从零开始,一步一步地指引你如何创建一个拉取请求。如果你想深入了解拉取请求的开发模式,可以参考 github [官方文档](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/about-pull-requests)