cn 我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

GitHub Discussions 快速入门

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

本文内容

注意:GitHub Discussions 目前处于测试阶段,可能会更改。

简介

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

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

在仓库中启用 GitHub Discussions

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

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

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

欢迎参与您的讨论

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

为贡献者设置社区指南

您可以设置参与指南,以鼓励协作者进行与仓库相关的有意义、有用的对话。 您还可以更新仓库的 README,以传达协作者何时应打开问题或讨论的期望。

有关为项目提供指南的更多信息,请参阅“为项目添加行为准则”和“设置健康参与的项目”。

创建新讨论

有权访问仓库的任何人都可以创建讨论。

  1. 在 GitHub 上,导航到仓库的主页面。
  2. Under your repository name, click Discussions.
    "Discussions" tab for a repository
  3. Click New discussion.
    "New discussion" button within the "Discussions" tab for a repository
  4. Select the Select Category drop-down menu, and click a category for your discussion.
    "Select Category" drop-down menu and list of available categories in a repository
  5. Type a title and body for your discussion.
    Text fields for new discussion's title and body
  6. Click Start discussion.
    "Start discussion" button

将讨论组织到相关类别

仓库所有者和具有写入权限的人可以创建新类别来保持讨论井然有序。 参与和创建新讨论的协作者可以将讨论分组到最相关的现有类别。 讨论也可以在创建后重新分类。 更多信息请参阅“管理仓库中讨论的类别”。

促进健康的对话

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

对仓库具有分类权限的人可以通过将评论标记为答案、锁定不再有用或对社区造成损害的讨论,以及在想法仍处于开发的早期阶段时将问题转换为讨论,从而帮助主持项目的讨论。 更多信息请参阅“主持讨论”。

后续步骤

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

此文档对您有帮助吗?

Privacy policy

帮助我们创建出色的文档!

所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。

做出贡献

或, 了解如何参与。