Git 与 AtomGit 实践：向上游仓库贡献内容

主要介绍了如何向上游仓库或其他开源项目贡献内容，以参与开源社区建设。

我们将以 my_open_source_contributions 作为上游仓库，如何向此仓库贡献内容为例，介绍如何参与开源项目。

1、账号准备与环境检查

提示：为确保顺利完成本练习，在操作前请先完整阅读《Git 与 AtomGit 实践：从零到一，单用户操作单仓库》，熟悉基本概念和操作后再继续。

1）注册 AtomGit 账号

2）验证手机号和邮箱

3）Git 环境配置

2. Fork（分叉/复制）上游仓库

贡献者在开始贡献前，需要先将上游仓库Fork到自己的AtomGit账号下：

打开您的浏览器，访问上游仓库页面：https://atomgit.com/atomgit_operate/my_open_source_contributions。
在仓库页面的右上角，点击"Fork"按钮，将仓库Fork到您的账户中。

3. 克隆Fork后的仓库

在本地机器上，请按照您的操作系统选择相应步骤操作，请将您的用户名替换为您的AtomGit用户名。

Windows 用户：

打开PowerShell：
- 点击"开始"菜单，输入"PowerShell"
- 点击"Windows PowerShell"以打开它
执行克隆命令：
- 在PowerShell窗口中，输入以下命令并按回车执行：
```
git clone git@atomgit.com:您的用户名/my_open_source_contributions.git
```
进入仓库目录：
```
cd my_open_source_contributions
```
打开项目目录：
```
start .
```

macOS 用户：

打开终端：
- 使用 Spotlight（Command + 空格）搜索"Terminal"
- 点击"Terminal"应用打开

执行克隆命令：

git clone git@atomgit.com:您的用户名/my_open_source_contributions.git

进入仓库目录：
```
cd my_open_source_contributions
```
打开项目目录：
```
open .
```

Linux 用户：

打开终端：
- 使用快捷键 Ctrl + Alt + T
- 或从应用程序菜单中打开终端

执行克隆命令：

git clone git@atomgit.com:您的用户名/my_open_source_contributions.git

进入仓库目录：
```
cd my_open_source_contributions
```
打开项目目录：
- 使用您的习惯编辑器或文件管理器打开当前目录：

4. 增删改文件并提交更改

创建和编辑文件：
- 在项目目录中，使用任意文本编辑器（如VS Code、Sublime Text、记事本等）
- 创建一个新文件，您可以自由选择文件名和类型，例如：
  - my_story.txt
  - project_ideas.md
  - notes.py
  - config.json
  - data.yaml
- 在新文件中添加任意内容，比如：
```
这是我开源贡献的历程
让我们一起开源贡献
```
- 编辑完成后保存更改
提交更改：
- 回到终端/PowerShell窗口，确保位于仓库目录中，执行：
```
git add .
git commit -m "添加新文件：记录我的开源历程"
```
  提示：如果执行 git commit 命令时提示需要配置用户名和邮箱，请阅读《Git 与 AtomGit 实践：从零到一，单用户操作单仓库》的“配置Git用户名和邮箱”。

5. 推送到Fork仓库

将本地的更改推送到自己Fork的仓库：

在终端/PowerShell中执行：

git push origin master

6. 提交变更请求（Change Request）

登录AtomGit：
- 打开您的浏览器，访问AtomGit并登录您的账户。
导航至Fork的仓库：
- 在您的账户页面中，找到并点击您 Fork 的仓库my_open_source_contributions，网址：https://atomgit.com/您的用户名/my_open_source_contributions。
提交Change Request：
- 点击仓库页面左侧菜单中的"变更请求"菜单。在"新建变更请求"页面，确保"来源"选择为您的账户下的Fork仓库的master分支。默认已经正确选择。目的分支选择为"上游仓库的master分支"。
- 填写Change Request的标题和描述，确保清晰说明所做的更改。例如：
  - 标题：添加新功能和开源寄语
  - 描述：本次提交包括添加“xxx”文件以及在main.txt中添加我的开源寄语，旨在丰富项目内容并表达对开源的支持。
  - 审核人：选择审核人（reviewers）来审核您的变更。
提交并等待审核：
- 点击"确定"按钮，完成变更请求的创建，等待维护者的审核。

注意：作为贡献者角色，到此完成了向上游仓库贡献内容。

7. 最佳实践

定期同步：保持本地仓库与上游仓库的同步，减少冲突发生。
详细提交信息：每次提交都应有清晰、详细的说明，便于他人理解更改内容。
内容审核：维护者应进行严格的内容审核，确保提交的质量。
选择审核人：提交Change Request时，选择审核人（reviewers）来审核您的变更。
书写清晰的Change Request描述：在提交Change Request时，提供详细的描述，说明更改的原因和内容，便于审核人员理解。

Git 与 AtomGit 实践：向上游仓库贡献内容​

1、账号准备与环境检查​

2. Fork（分叉/复制）上游仓库​

3. 克隆Fork后的仓库​

Windows 用户：​

macOS 用户：​

Linux 用户：​

4. 增删改文件并提交更改​

5. 推送到Fork仓库​

6. 提交变更请求（Change Request）​

7. 最佳实践​

推荐阅读​