跳至主要内容

GitHub 讨论快速入门

在现有仓库或组织上启用 GitHub 讨论,并与社区开展对话。

简介

GitHub Discussions 是面向开源或内部项目的社区的协作沟通论坛。讨论用于需要透明且可访问的对话,但不需要在项目中进行追踪,也不涉及代码,这与 GitHub Issues 不同。讨论在公开的论坛中实现流畅、开放的交流。

讨论提供了一个更具协作性的交流空间,通过连接并提供更集中的区域来获取信息。

在您的仓库上启用 GitHub 讨论

仓库所有者和拥有写入权限的用户可以在其公共或私有仓库上为社区启用 GitHub Discussions。讨论的可见性继承自创建该讨论的仓库。

首次启用 GitHub Discussions 时,系统将邀请您配置欢迎帖。

  1. 在 GitHub 上,导航至仓库的主页面。

  2. 在仓库名称下,点击 设置.

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

  3. 向下滚动至 “Features(功能)” 部分,点击 Set up discussions(设置讨论)

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

  4. 在 “Start a new discussion(开始新讨论)” 下,编辑模板以符合您希望为社区制定的资源和语调。

  5. 单击 Start discussion

在您的组织上启用 GitHub 讨论

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

启用组织讨论时,您需要在组织中选择一个仓库作为组织讨论的源仓库。您可以使用已有的仓库,也可以创建一个专门用于存放组织讨论的仓库。讨论将同时出现在组织的 Discussions 页面和源仓库的讨论页面上。

在组织中参与或管理讨论的权限取决于源仓库的权限。例如,用户必须对源仓库拥有写入权限才能删除组织讨论。这与用户在仓库中需要写入权限才能删除仓库讨论的情况相同。

您可以随时更改源仓库。但更改源仓库后,原有讨论不会转移到新的源仓库。

  1. 在 GitHub 上,前往您组织的主页。

  2. 在组织名称下,点击 设置.

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

  3. 在 “Discussions(讨论)” 下,选择 Enable discussions for this organization(为此组织启用讨论)

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

  5. 点击保存

欢迎对您讨论的贡献

您可以通过创建欢迎帖并将其置顶到 GitHub Discussions 页面,向社区致意并介绍在仓库或组织中进行沟通的新方式。置顶并锁定讨论可让人们知道该帖子是公告性质。您可以使用公告来链接更多资源并为社区开启讨论提供指引。有关置顶讨论的更多信息,请参阅 Managing discussions(管理讨论)

为贡献者制定社区指南

对于仓库讨论,您可以设置贡献指南,鼓励协作者进行有意义、实用且与仓库相关的对话。您还可以更新仓库的 README,以说明在何种情况下协作者应开启 Issue 或讨论。有关为项目提供指南的更多信息,请参阅 Adding a code of conduct to your project(为项目添加行为准则)Setting up your project for healthy contributions(为健康贡献设置项目)

对于组织讨论,您可以通过创建组织简介 README 来分享如何与组织互动的信息。更多信息,请参阅 Customizing your organization's profile(自定义组织简介)

创建新讨论

任何可以查看仓库的已认证用户都可以在该仓库中创建讨论。同样,由于组织讨论基于源仓库,任何可以查看源仓库的已认证用户都可以在该组织中创建讨论。

  1. 在 GitHub 上,前往您想要发起讨论的仓库或组织的主页。

  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. 单击 Start discussion

创建新投票

任何可以查看仓库的已认证用户都可以创建投票。同样,由于组织讨论基于源仓库,任何可以查看源仓库的已认证用户都可以在该组织中创建投票。

  1. 在 GitHub 上,导航至仓库的主页面。

  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. 点击 开始投票

组织讨论

仓库所有者和拥有写入权限的用户可以创建新分类,以保持讨论的有序。同样,由于组织讨论基于源仓库,仓库所有者和拥有写入权限的用户可以为组织讨论创建新分类。

参与并创建新讨论的协作者可以将讨论归入最相关的现有分类。讨论也可以在创建后重新分类。有关更多信息,请参阅 Managing categories for discussions(管理讨论分类)

若要更细致地组织讨论,您可以使用标签。例如,您可以使用标签指示讨论的状态,从而提升分拣效率。每个仓库都有一套共享的标签,适用于 Issue、Pull Request 和讨论。有关更多信息,请阅 Managing labels(管理标签)

促进健康对话

拥有仓库写入权限(或组织讨论的源仓库写入权限)的人可以通过置顶讨论、删除不再有用或对社区有害的讨论,以及将讨论转移到组织拥有的更相关仓库,来提升重要对话的可见性。有关更多信息,请参阅 Managing discussions(管理讨论)

拥有仓库分流(triage)权限(或组织讨论的源仓库分流权限)的人可以通过将评论标记为答案、锁定不再有用或对社区有害的讨论,以及在想法仍处于早期阶段时将 Issue 转换为讨论,来协助项目的讨论管理。有关更多信息,请参阅 Moderating discussions(讨论审核)

后续步骤

一旦明确了工作范围并将想法从概念转为现实的路径,您就可以创建 Issue 并开始跟踪进度。有关如何从讨论创建 Issue 的更多信息,请参阅 Moderating discussions(讨论审核)

© . This site is unofficial and not affiliated with GitHub, Inc.