跳至主要内容

关于讨论

使用讨论来提问和解答问题、共享信息、发布公告以及在 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 社区讨论

进一步阅读