关于 GitHub Discussions
使用 GitHub Discussions,项目的社区可以在项目存储库或组织中创建和参与对话。 讨论使项目的维护者、参与者和访问者能够在没有第三方工具的情况下,在中心位置收集和完成以下目标。
- 共享公告和信息、收集反馈、计划和决策
- 提出问题、讨论和回答问题,以及将讨论标记为已回答
- 创建投票以衡量社区意见
- 投票支持讨论和评论,让你认为有价值的观点更容易被看到
- 为访客和贡献者营造一种邀请的氛围,讨论目标、发展、管理和工作流程
你可以使用存储库讨论来讨论特定于存储库的主题。 如果项目跨越多个存储库,则可以使用组织讨论来讨论不特定于组织中单个存储库的主题。
当讨论已解决、不再相关或重复时,你可以关闭讨论。 有关详细信息,请参阅“关闭讨论”。
如果存储库管理员或项目维护者为存储库启用 GitHub Discussions,则任何有权访问存储库的人都可以创建和参与存储库的讨论。 如果组织所有者为组织启用 GitHub Discussions,则查看源存储库的任何人都可以创建组织讨论。
仓库管理员和项目维护者可以管理仓库中的讨论和讨论类别,并固定讨论以提高讨论的可见性。 主持人和协作者可以将评论标记为答案、锁定讨论并将议题转换为讨论。 同样,对于组织讨论,源存储库中用户的角色决定了用户与组织讨论的交互方式。 有关详细信息,请参阅“组织的存储库角色”。
有关讨论管理的详细信息,请参阅“管理讨论”。
关于投票
可以在投票类别中创建投票,以衡量对新想法和项目方向的兴趣。 对存储库具有读取权限的任何人都可以创建投票、投票并查看结果。
投票需要一个问题和至少两个选项。 最多可以添加 8 个选项,长度不超过 128 个字符。
投票者不能改变他们的投票。 编辑投票将重置已投出的任何投票。
有关创建投票的详细信息,请参阅“参与讨论”。
关于讨论组织
可以使用类别、部分和标签来组织讨论。
您可以对讨论进行分类,以帮助社区成员在正确的位置开始对话,并帮助社区成员查找相关的讨论。 所有讨论都必须在类别中创建。 对于存储库讨论,由对存储库具有维护权限或管理员权限的人员定义该存储库中讨论的类别。 对于组织讨论,由对源存储库具有维护权限或管理员权限的人员定义该组织中讨论的类别。 每个类别都有一个格式:开放式讨论、问答或公告。 每个存储库或组织最多可以有 25 个类别。
对于采用问题/答案格式的讨论,讨论中的单个评论可以标记为讨论的答案。 GitHub 将自动识别贡献最多评论的社区成员,将评论标记为问题/回答格式的讨论答案。
维护者可以使用通知格式的类别来分享信息、发布或事件。 为了使这些类别的讨论集中于重要的更新,只有拥有维护或管理权限的人才可创建新的讨论,但任何人都可以评论和回复。
若要进一步组织讨论,可以创建部分,然后将类别嵌套在部分中。
有关详细信息,请参阅“管理讨论类别”。
为了更精细地组织讨论,您可以应用标签。 例如,您可以使用标签来表示讨论的状态,以提高分类效率。 每个仓库都有一组用于议题、拉取请求和讨论的共享标签。 有关详细信息,请参阅“管理标签”。
GitHub Discussions 的最佳实践
作为社区成员或维护者,发起讨论以提出问题或讨论影响社区的信息。 有关详细信息,请参阅“使用讨论与维护者协作”。
参与讨论、提出问题和回答问题、提供反馈,以及与项目的社区互动。 有关详细信息,请参阅“参与讨论”。
您可以突出讨论社区成员之间重要、有益或堪称典范的对话。 有关详细信息,请参阅“管理讨论”。
如果议题原来是问题或开放式对话,而不是要跟踪和确定优先级的工作项,则您可以将议题转换为讨论。 有关详细信息,请参阅“主持讨论”。
分享反馈
您可以与 GitHub 分享您对 GitHub Discussions 的反馈。 若要加入对话,请参阅 GitHub Community 讨论。
延伸阅读
- “关于在 GitHub 上编写和设置格式”
- “搜索讨论”
- "关于通知"
- “调解评论和对话”