跳至主要内容

关于讨论

使用讨论来提出和回答问题、分享信息、发布公告,以及在 GitHub 上就项目进行对话或参与对话。

关于 GitHub 讨论

使用 GitHub 讨论,项目的社区可以在项目的存储库或组织内创建对话并参与对话。讨论让项目的维护者、贡献者和访问者能够在中心位置收集和实现以下目标,而无需第三方工具。

  • 分享公告和信息、收集反馈、规划和做出决策
  • 提出问题、讨论并回答问题,并将讨论标记为已回答
  • 创建投票以衡量社区意见
  • 对讨论和评论投赞成票,以提高你认为有价值的想法的知名度
  • 营造一个友好的氛围,让访问者和贡献者讨论目标、开发、管理和工作流

Screenshot of the "Discussions" page for a GitHub repository, showing a list of discussions such as "Feedback on the new layout" and "Project direction".

你可以使用存储库讨论来讨论特定于存储库的主题。如果你的项目跨越多个存储库,你可以使用组织讨论来讨论不特定于组织中单个存储库的主题。

当讨论已解决、不再相关或重复时,你可以关闭讨论。有关详细信息,请参阅“关闭讨论”。

如果存储库管理员或项目维护者为存储库启用了 GitHub 讨论,则任何有权访问该存储库的人都可以创建讨论并参与该存储库的讨论。如果组织所有者为组织启用了 GitHub 讨论,则任何可以查看源存储库的人都可以创建组织讨论。

存储库管理员和项目维护者可以在存储库中管理讨论和讨论类别,并将讨论固定以提高讨论的知名度。版主和协作者可以将评论标记为答案、锁定讨论并将问题转换为讨论。同样,对于组织讨论,用户在源存储库中的角色决定了用户如何与组织讨论进行交互。有关详细信息,请参阅“组织的存储库角色”。

有关讨论管理的更多信息,请参阅“管理讨论”。

关于投票

您可以在投票类别中创建投票,以衡量对新想法和项目方向的兴趣。任何有权读取存储库的人都可以创建投票、在投票中投票并查看投票结果。已注销的用户可以查看公共存储库中投票的结果。

投票需要一个问题和至少两个选项。您最多可以添加八个选项,每个选项最多可以包含 128 个字符。

投票者无法更改自己的投票。编辑投票将重置已投的任何票数。

有关创建投票的更多信息,请参阅“参与讨论”。

关于讨论组织

您可以使用类别、部分和标签组织讨论。

您可以对讨论进行分类,以帮助社区成员在正确的地方开始对话,并帮助社区成员找到相关的讨论。所有讨论都必须在某个类别中创建。对于存储库讨论,具有存储库的维护或管理员权限的人员定义该存储库中讨论的类别。对于组织讨论,具有源存储库的维护或管理员权限的人员定义该组织中讨论的类别。每个类别都有一个格式:开放式讨论、问答或公告。每个存储库或组织最多可以有 25 个类别。

对于采用问答格式的讨论,讨论中的单个评论可以标记为讨论的答案。GitHub 将自动识别在采用问答格式的讨论中为标记为答案的评论做出最多贡献的社区成员。

维护者可以使用采用公告格式的类别来共享信息、发布或事件。为了使这些类别中的讨论集中在重要更新上,只有具有维护或管理员权限的人员才能创建新讨论,但任何人都可以评论和回复。

为了进一步组织您的讨论,您可以创建部分,然后将类别嵌套在部分中。

有关更多信息,请参阅“管理讨论的类别”。

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

GitHub 讨论的最佳实践

作为社区成员或维护者,可以发起讨论来提问或讨论影响社区的信息。有关更多信息,请参阅“使用讨论与维护者协作”。

参与讨论以提问和回答问题、提供反馈并与项目的社区互动。有关更多信息,请参阅“参与讨论”。

你可以重点关注包含社区成员之间重要、有用或示范性对话的讨论。有关更多信息,请参阅“管理讨论”。

如果问题变成一个问题或开放式对话,而不是要跟踪和优先处理的工作项,你可以将问题转换为讨论。有关更多信息,请参阅“主持讨论”。

分享反馈

你可以与 GitHub 分享你对 GitHub 讨论的反馈。要加入对话,请参阅 GitHub 社区讨论

进一步阅读