GitHub 讨论快速入门

在现有存储库或组织上启用 GitHub 讨论，并开始与您的社区进行对话。

本文档

简介

GitHub 讨论是围绕开源或内部项目社区的协作式交流论坛。讨论适用于需要透明和可访问但不需要在项目中跟踪且与代码无关的对话，与 GitHub 问题不同。讨论在公共论坛中实现流畅、开放的对话。

讨论通过连接和提供更集中的区域来连接和查找信息，从而为更具协作性的对话提供空间。

在您的仓库中启用 GitHub 讨论

仓库所有者和具有写入权限的人员可以为其公共和私有仓库中的社区启用 GitHub 讨论。讨论的可见性继承自创建讨论的仓库。

首次启用 GitHub 讨论时，您将被邀请配置欢迎帖子。

  1. 在 GitHub.com 上，导航到仓库的主页。

  2. 在您的仓库名称下，单击 设置.

    Screenshot of the tabs in a GitHub repository. The "Settings" option is outlined in dark orange.

  3. 向下滚动到“功能”部分，然后单击**设置讨论**。

    Screenshot of the "Discussions" option in the repository's settings. A green button, labeled "Set up discussions", is outlined in dark orange.

  4. 在“开始新的讨论”下，编辑模板以与您希望为社区设置的资源和语气保持一致。

  5. 单击**开始讨论**。

在您的组织中启用 GitHub 讨论

组织所有者可以为其组织启用 GitHub 讨论。

启用组织讨论时，您将选择组织中的一个仓库作为组织讨论的源仓库。您可以使用现有仓库或专门创建一个仓库来保存您的组织讨论。讨论将显示在组织的讨论页面和源仓库的讨论页面上。

参与或管理组织中讨论的权限基于源仓库中的权限。例如，用户需要对源仓库具有写入权限才能删除组织讨论。这与用户需要对仓库具有写入权限才能删除仓库讨论相同。

您可以随时更改源仓库。如果您更改源仓库，讨论不会转移到新的源仓库。

  1. 在 GitHub.com 上，导航到您组织的主页。

  2. 在您的组织名称下，单击 设置.

    Screenshot of the tabs in an organization's profile. The "Settings" tab is outlined in dark orange.

  3. 在“讨论”下，选择**为该组织启用讨论**。

  4. 使用下拉菜单选择一个仓库作为组织讨论的源仓库。

  5. 单击**保存**。

欢迎参与您的讨论

您可以通过创建欢迎帖子并将其固定到您的 GitHub 讨论页面来欢迎您的社区并介绍一种新的沟通方式。固定和锁定讨论可以帮助人们了解帖子是作为公告发布的。您可以使用公告将人们链接到更多资源，并为在您的社区中开启讨论提供指导。有关固定讨论的更多信息，请参阅“管理讨论”。

为贡献者设置社区指南

对于存储库讨论，您可以设置贡献指南，以鼓励协作者进行有意义、有用的对话，这些对话与存储库相关。您还可以更新存储库的 README 以传达协作者何时应打开问题或讨论的期望。有关为您的项目提供指南的更多信息，请参阅“向您的项目添加行为准则”和“为您的项目设置健康的贡献”。

对于组织讨论，您可以通过创建组织配置文件 README 来分享有关如何与您的组织互动的信息。有关更多信息，请参阅“自定义您的组织配置文件”。

创建新的讨论

任何可以查看存储库的已认证用户都可以创建该存储库中的讨论。同样，由于组织讨论基于源存储库，因此任何可以查看源存储库的已认证用户都可以创建该组织中的讨论。

  1. 在 GitHub.com 上，导航到您要开始讨论的存储库或组织的主页。

  2. 在您的存储库或组织名称下，单击 讨论.

    Screenshot of the tabs in a GitHub repository. The "Discussions" option is outlined in dark orange.

  3. 在页面右侧，单击**新建讨论**。

  4. 通过单击**开始**选择讨论类别。

    Screenshot of the "Select a discussion category" page. A button, labeled "Get started", is outlined in dark orange.

  5. 在“讨论标题”下，输入讨论的标题，在“撰写”下，输入讨论的内容。

    Screenshot of the text fields for the title and body for a new discussion.

  6. 单击**开始讨论**。

创建新的投票

任何经过身份验证且可以查看仓库的用户都可以创建投票。同样，由于组织讨论基于源仓库，因此任何经过身份验证且可以查看源仓库的用户都可以在该组织中创建投票。

  1. 在 GitHub.com 上，导航到仓库的主页。

  2. 在您的存储库或组织名称下，单击 讨论.

    Screenshot of the tabs in a GitHub repository. The "Discussions" option is outlined in dark orange.

  3. 在类别列表中，点击 **投票**。

    Screenshot of the categories section in the "Discussions" tab. The "Poll" category is outlined in dark orange.

  4. 在右侧，点击 **新建讨论**。

  5. 在“讨论标题”下，输入标题，并在“撰写”下，可选地输入投票的内容。

    Screenshot of the page to start a new poll.

  6. 在“投票问题”下，输入投票的问题。

  7. 在“投票选项”下，输入至少两个投票选项。

  8. 可选地，要添加额外的投票选项，请点击 ** 添加选项**。

    Screenshot of the page to start a new poll. The plus icon and "Add an option" are outlined in dark orange.

  9. 点击 **开始投票**。

组织讨论

仓库所有者和拥有仓库写入权限的人员可以创建新的类别来保持讨论的有序。同样，由于组织讨论基于源仓库，因此仓库所有者和拥有源仓库写入权限的人员可以为组织讨论创建新的类别。

参与和创建新讨论的协作者可以将讨论分组到最相关的现有类别中。讨论也可以在创建后重新分类。有关更多信息，请参阅“管理讨论类别”。

为了更细致地组织讨论，您可以使用标签。例如，您可以使用标签来指示讨论的状态，以提高分类效率。每个仓库都有一套共享的标签，用于问题、拉取请求和讨论。有关更多信息，请参阅“管理标签”。

促进健康的对话

拥有仓库写入权限的人员，或拥有组织讨论源仓库写入权限的人员，可以通过固定讨论、删除不再有用或对社区有害的讨论以及将讨论转移到组织拥有的更相关的仓库来帮助突出显示重要的对话。有关更多信息，请参阅“管理讨论”。

拥有仓库分类权限的人员，或拥有组织讨论源仓库分类权限的人员，可以通过将评论标记为答案、锁定不再有用或对社区有害的讨论以及在想法处于早期开发阶段时将问题转换为讨论来帮助管理项目的讨论。有关更多信息，请参阅“管理讨论”。

下一步

一旦有了明确的路径来确定工作范围并将想法从概念转化为现实，您就可以创建一个问题并开始跟踪您的进度。有关从讨论创建问题的更多信息，请参阅“管理讨论”。