# 在GitHub上交流

你可以在 GitHub 上使用不同类型的讨论来讨论具体的项目和变更，以及更宏观的想法或团队目标。

## 简介

GitHub 提供内置的协作通信工具，使你能够与社区密切互动。 此快速入门指南将指导您如何根据您的需求选择合适的工具。

根据您想参加的对话类型，您可以创建和参加议题、拉取请求和团队讨论。

### GitHub Issues

* 适用于讨论项目的具体细节，如 Bug 报告、计划的改进和反馈
* 是特定于存储库的，通常有一个明确的所有者
* 通常被称为 GitHub 的缺陷跟踪系统

### 拉取请求

* 允许你提出具体的更改
* 允许你直接评论其他人建议的更改
* 是特定于仓库的

## 我应该使用哪种讨论工具？

### 问题情境

* 我想跟踪任务、功能增强和缺陷。
* 我想提交错误报告。
* 我想分享有关特定功能的反馈。
* 我想询问有关仓库文件的问题。

#### 问题示例

此示例说明了 GitHub 用户如何在我们的文档开源存储库中创建问题，以让我们知晓一个 bug，并讨论修复方案。

![问题的屏幕截图，标题为“通知中的蓝色链接文本由于蓝色背景而无法阅读”。](/assets/images/help/issues/issue-example.png)

* 用户注意到，文档中文版 GitHub 页面顶部横幅的蓝色使横幅中的文本不可读。
* 用户在仓库中创建一个议题，指出了问题并提出了修复建议（即对横幅使用不同的背景色）。
* 随后进行了讨论，最终就适用的修复方法达成共识。
* 然后，参与者可以创建包含修复方法的拉取请求。

### 拉取请求场景

* 我想在代码库中修改拼写错误。
* 我想对代码库进行更改。
* 我想进行更改以修复问题。
* 我想评论其他人建议的更改。

#### 拉取请求示例

此示例说明了GitHub用户如何在我们的文档开源仓库中创建拉取请求来修复一个拼写错误。

在拉取请求的“对话”选项卡，作者解释了其创建拉取请求的原因。

![拉取请求的“对话”选项卡的屏幕截图。](/assets/images/help/pull_requests/pr-conversation-example.png)

拉取请求的“文件更改”选项卡显示所实施的修复。

![拉取请求的“已更改的文件”选项卡的屏幕截图。](/assets/images/help/pull_requests/pr-files-changed-example.png)

* 此参与者发现仓库中的拼写错误。
* 用户创建包含修复方法的拉取请求。
* 仓库维护员审查拉取请求、发表评论并合并它。

### 适用于 GitHub Discussions 的场景

* 我有一个不一定与仓库中的特定文件相关的问题。
* 我想与协作者或团队分享消息。
* 我想发起或参与开放式对话。
* 我想向社区发布公告。

#### GitHub Discussions 示例

此示例展示了 GitHub Discussions Docs 开源存储库的 GitHub 欢迎帖子，并说明了该团队希望如何与社区协作。

![讨论示例的屏幕截图，标题为“欢迎GitHub Docs 讨论”。](/assets/images/help/discussions/github-discussions-example.png)

这位社区维护员发起讨论以欢迎社区成员，并请成员自我介绍。 这个帖子营造了欢迎访客和参与者的氛围。 这个帖子还阐明，团队乐于帮助用户对仓库做出贡献。

## 后续步骤

这些示例向你展示了如何确定在 GitHub 上进行对话时哪种工具最适合你。 但这仅仅是个开始；您可以做更多的工作来根据需求定制这些工具。

例如，对于议题，您可以用标签标记议题以支持更快的搜索，并创建议题模板以帮助参与者打开有意义的议题。 有关详细信息，请参阅 [关于问题](/zh/enterprise-server@3.22/issues/tracking-your-work-with-issues/learning-about-issues/about-issues) 和 [关于议题和拉取请求模板](/zh/enterprise-server@3.22/communities/using-templates-to-encourage-useful-issues-and-pull-requests/about-issue-and-pull-request-templates)。

对于拉取请求，如果您提议的更改仍在进行中，您可以创建拉取请求草稿。 草稿拉取请求在标记为可供审查之前无法合并。 有关详细信息，请参阅“[拉取请求](/zh/enterprise-server@3.22/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests#draft-pull-requests)”。

对于 GitHub Discussions，你可以固定包含社区重要信息的讨论。 有关详细信息，请参阅“[关于讨论](/zh/enterprise-server@3.22/discussions/collaborating-with-your-community-using-discussions/about-discussions)”。

若要了解一些有助于传达的高级格式设置功能，请参阅“[GitHub上写作的快速入门指南](/zh/enterprise-server@3.22/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github)”。