# 在GitHub上交流

你可以在 GitHub 中使用不同类型的讨论来讨论特定项目和更改，以及更广泛的想法或团队目标。

## 简介

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

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

> \[!TIP] 您还可以使用 副驾驶聊天 来基于您的拉取请求和问题生成用于讨论的创意、大纲或草稿。 请参阅“[撰写讨论或博客文章](/zh/enterprise-cloud@latest/copilot/copilot-chat-cookbook/documenting-code/writing-discussions-or-blog-posts)”。

### GitHub Issues

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

### 拉取请求

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

### GitHub Discussions

* 就像一个论坛，最好用来进行合作很重要的开放式想法和讨论
* 可能跨越许多仓库
* 在代码库之外提供协作体验，从而集思广益，并创建社区知识库
* 往往没有明确的所有者
* 通常不会导致可操作的任务

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

### 问题情境

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

#### 问题示例

此示例说明了 GitHub 用户如何在我们的文档开源仓库中创建议题，以便让我们了解错误并讨论修复方法。

![问题的屏幕截图，标题为“通知中的蓝色链接文本由于蓝色背景而无法阅读”。](/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 文档开源仓库的 GitHub 欢迎帖子，并说明了团队希望如何与社区合作。

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

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

## 使用 Copilot 获取上下文

> \[!NOTE] 你需要对 GitHub Copilot 的访问权限。 有关详细信息，请参阅“[什么是GitHub Copilot？](/zh/enterprise-cloud@latest/copilot/about-github-copilot/what-is-github-copilot#getting-access-to-copilot)”。

如果你需要更多上下文或对特定议题或讨论的澄清，可以使用 GitHub Copilot 来帮助解答你的问题。 这使你能够快速获得见解，理解复杂的讨论，并保持与项目目标的一致性，从而促进社区内的协作和知识共享。

询问有关议题或讨论的问题：

1. 从 GitHub的任何位置，单击页面右上角搜索栏旁边的 **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-copilot" aria-label="Copilot" role="img"><path d="M7.998 15.035c-4.562 0-7.873-2.914-7.998-3.749V9.338c.085-.628.677-1.686 1.588-2.065.013-.07.024-.143.036-.218.029-.183.06-.384.126-.612-.201-.508-.254-1.084-.254-1.656 0-.87.128-1.769.693-2.484.579-.733 1.494-1.124 2.724-1.261 1.206-.134 2.262.034 2.944.765.05.053.096.108.139.165.044-.057.094-.112.143-.165.682-.731 1.738-.899 2.944-.765 1.23.137 2.145.528 2.724 1.261.566.715.693 1.614.693 2.484 0 .572-.053 1.148-.254 1.656.066.228.098.429.126.612.012.076.024.148.037.218.924.385 1.522 1.471 1.591 2.095v1.872c0 .766-3.351 3.795-8.002 3.795Zm0-1.485c2.28 0 4.584-1.11 5.002-1.433V7.862l-.023-.116c-.49.21-1.075.291-1.727.291-1.146 0-2.059-.327-2.71-.991A3.222 3.222 0 0 1 8 6.303a3.24 3.24 0 0 1-.544.743c-.65.664-1.563.991-2.71.991-.652 0-1.236-.081-1.727-.291l-.023.116v4.255c.419.323 2.722 1.433 5.002 1.433ZM6.762 2.83c-.193-.206-.637-.413-1.682-.297-1.019.113-1.479.404-1.713.7-.247.312-.369.789-.369 1.554 0 .793.129 1.171.308 1.371.162.181.519.379 1.442.379.853 0 1.339-.235 1.638-.54.315-.322.527-.827.617-1.553.117-.935-.037-1.395-.241-1.614Zm4.155-.297c-1.044-.116-1.488.091-1.681.297-.204.219-.359.679-.242 1.614.091.726.303 1.231.618 1.553.299.305.784.54 1.638.54.922 0 1.28-.198 1.442-.379.179-.2.308-.578.308-1.371 0-.765-.123-1.242-.37-1.554-.233-.296-.693-.587-1.713-.7Z"></path><path d="M6.25 9.037a.75.75 0 0 1 .75.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 .75-.75Zm4.25.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 1.5 0Z"></path></svg>** 图标。

   ![“新建对话”按钮的屏幕截图，以深橙色边框突出显示。](/assets/images/help/copilot/copilot-icon-top-right.png)

2. 在“Ask Copilot”框中，输入一个问题并在消息中包含相关的 URL。 例如，可以询问：

   * `Explain https://github.com/monalisa/octokit/issues/1`
   * `Summarize https://github.com/monalisa/octokit/discussions/4`
   * `Recommend next steps for https://github.com/monalisa/octokit/issues/2`
   * `What are the acceptance criteria for ISSUE URL?`
   * `What are the main points made by PERSON in DISCUSSION URL?`

   如果在特定的议题或讨论中与 GitHub Copilot 聊天，则无需在问题中包含 URL。

3. 或者，提交问题后，可以在文本框中单击 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-square-fill" aria-label="Stop" role="img"><path d="M5.75 4h4.5c.966 0 1.75.784 1.75 1.75v4.5A1.75 1.75 0 0 1 10.25 12h-4.5A1.75 1.75 0 0 1 4 10.25v-4.5C4 4.784 4.784 4 5.75 4Z"></path></svg> 以停止响应。

## 后续步骤

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

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

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

对于 GitHub Discussions，可以设置行为准则并将包含社区重要信息的讨论置顶。 有关详细信息，请参阅“[关于讨论](/zh/enterprise-cloud@latest/discussions/collaborating-with-your-community-using-discussions/about-discussions)”。

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