如何在 GitHub 上创建新文档

当您准备好提交您的原始书面文档以供批准时，请按照以下简单步骤操作

使用 GitHub GUI

您可以在 GitHub 上的 Web GUI 完成几乎所有任务。以下是如何将您在本地机器上创建的文件添加到 Rocky Linux 文档 GitHub 仓库的示例。

1. 登录您的 GitHub 帐户。
2. 导航到 Rocky Linux 文档仓库，地址为 https://github.com/rocky-linux/documentation.
3. 您应该位于“Main”分支，因此请检查中间部分的下拉标签以确保您在该分支中。您的文档最终可能不会位于“Main”分支中，但管理员稍后会将其移动到逻辑上合适的位置。
4. 在页面的右侧，单击 Fork 按钮，这将创建您自己的文档副本。
5. 在分叉副本的页面中间，在绿色“Code”下拉菜单左侧，有一个 Add file 按钮。单击它并选择“Upload files”选项。
6. 这将允许您将文件拖放到这里，或浏览您计算机上的文件。请选择您喜欢的任何方法。
7. 上传完文件后，您需要做的下一件事是创建拉取请求。此请求让上游管理员知道您有一个新的文件（或多个文件），您希望他们将其与主分支合并。
8. 单击屏幕左上角的 Pull Request。
9. 在“Write”部分中写一条简短的消息，让管理员知道您做了什么（新文档，修订，建议更改等），然后提交您的更改。

从 Git 命令行

如果您更喜欢在本地机器上运行 Git，可以克隆 Rocky Linux 文档 仓库，进行更改，然后提交更改。为了简化操作，请执行上面“使用 GitHub GUI”方法中的步骤 1-3，然后

1. 克隆 Git 仓库

   git clone https://github.com/your_fork_name/documentation.git
   

2. 现在，在您的机器上，将文件添加到该目录。例如

   mv /home/myname/help.md /home/myname/documentation/
   

3. 接下来，为该文件名运行 Git add。例如

   git add help.md
   

4. 现在，运行 git commit 来提交您所做的更改。例如

   git commit -m "Added the help.md file"
   

5. 接下来，将您的更改推送到您分叉的仓库

   git push https://github.com/your_fork_name/documentation main
   

6. 接下来，重复上面的步骤 6 和 7：创建拉取请求。此请求让上游管理员知道您有一个新的文件（或多个文件），您希望他们将其与主分支合并。单击屏幕左上角的 Pull Request。

注意 PR 中的评论以了解请求的修订和澄清。

作者: Ezequiel Bruni

贡献者: Grammaresque，Ganna Zhyrnova