Skip to main content

GitHub Discussions 快速入门

在现有仓库或组织上启用 GitHub Discussions ,并发起与社区的对话。

简介

GitHub Discussions 是一个围绕开源项目为社区提供协作沟通的论坛。 不像 GitHub Issues,讨论用于需要透明和可访问的对话,但不需要在项目板上进行跟踪,并且与代码无关。 讨论使公共论坛中能够进行流畅、公开的对话。

通过连接和提供更集中的区域来连接和查找信息,讨论为更多协作对话提供了空间。

在仓库中启用 GitHub Discussions

仓库所有者和具有写入访问权限的人可在其公共和私有仓库中为社区启用 GitHub Discussions。

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

  1. 在 GitHub.com 上,导航到仓库的主页面。
  2. 在仓库名称下,单击 Settings(设置)公共设置按钮
  3. 在“Features(功能)”下,单击 Set up discussions(设置讨论)在"Features(功能)"下设置讨论按钮,用于对仓库启用或禁用 GitHub Discussions
  4. 在“Start a new discussion(开始新讨论)”下,编辑模板以与要为社区设置的资源和语气保持一致。
  5. 单击 Start discussion(开始讨论)"Start discussion(开始讨论)"按钮

在组织上启用 GitHub Discussions

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

When you enable organization discussions, you will choose a repository in the organization to be the source repository for your organization discussions. You can use an existing repository or create a repository specifically to hold your organization discussions. Discussions will appear both on the discussions page for the organization and on the discussion page for the source repository.

Permission to participate in or manage discussion in your organization is based on permission in the source repository. For example, a user needs write permission to the source repository in order to delete an organization discussion. This is identical to how a user needs write permission in a repository in order to delete a repository discussion.

You can change the source repository at any time. If you change the source repository, discussions are not transferred to the new source repository.

  1. 在 GitHub.com 上,导航到组织的主页面。
  2. Under your organization name, click Settings. 组织设置按钮
  3. Under "Discussions", select Enable discussions for this organization.
  4. Select a repository to use as the source repository for your organization discussions. Settings to enable discussions for an organization
  5. 单击 Save(保存)

欢迎参与您的讨论

您可以欢迎您的社区,并通过创建欢迎帖子并将帖子固定到您的 GitHub Discussions 页面,在存储库或组织中引入一种新的沟通方式。 固定和锁定讨论有助于人们知道帖子是作为公告发布的。 您可以使用公告将人员链接到更多资源,并指导在社区中开始讨论。 有关固定讨论的详细信息,请参阅“管理讨论”。

为贡献者设置社区指南

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

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

创建新讨论

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

  1. 在 GitHub.com 上,导航到要在其中开始讨论的存储库或组织的主页。
  2. 在您的存储库或组织名称下,单击 Discussions(讨论)仓库的"Discussions(讨论)"选项卡
  3. 单击 New discussion(新讨论)仓库的"Discussions(讨论)"选项卡中的"New discussion(新讨论)"按钮
  4. 选择 Select Category(选择类别)下拉菜单,然后单击讨论的类别。 "Select Category(选择类别)"下拉菜单和仓库中可用类别的列表
  5. 输入讨论的标题和正文。 新讨论标题和正文的文本字段
  6. 单击 Start discussion(开始讨论)"Start discussion(开始讨论)"按钮

创建新投票

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

  1. 在 GitHub.com 上,导航到仓库的主页面。
  2. 在您的存储库或组织名称下,单击 Discussions(讨论)仓库的"Discussions(讨论)"选项卡
  3. In the list of categories, click Polls. Screenshot showing "Poll" category
  4. On the right, click Start poll. Screenshot showing the "Start poll" button
  5. Type a title and optional body for your poll. Screenshot showing text fields for title and body
  6. Type a question for your poll. Screenshot showing text fields for the poll's question
  7. Type at least two options for your poll. Screenshot showing text fields for the poll's options
  8. Optionally, to add a extra poll options, click Add an option. Screenshot showing "Add an option" button
  9. Click Start poll. Screenshot showing the "Start poll" button

组织讨论

仓库所有者和对仓库具有写入权限的人可以创建新类别来保持讨论井然有序。 同样,由于组织讨论基于源存储库,因此存储库所有者和对源存储库具有写入访问权限的人员可以为组织讨论创建新类别。

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

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

促进健康的对话

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

对存储库或组织讨论的源存储库具有分类权限的人员,可以通过将评论标记为答案、锁定不再有用或对社区有害的讨论,以及在想法仍处于开发的早期阶段时将议题转换为讨论,来帮助调节项目的讨论。 更多信息请参阅“主持讨论”。

后续步骤

一旦有明确的路径来确定范围以及将想法从概念变为现实,您就可以创建议题并开始跟踪进度。 有关从讨论创建议题的更多信息,请参阅“主持讨论”。