跳至主要内容

使用讨论与维护者协作

您可以在 GitHub 上通过与项目的维护者在讨论中交流,为项目的目标、计划、健康状况和社区做出贡献。

谁可以使用此功能?

具有仓库读取权限的人员可以在仓库中启动和参与讨论和投票。具有组织讨论源仓库读取权限的人员可以在组织中启动和参与讨论和投票。

关于使用 GitHub 讨论与维护者协作

GitHub 讨论是 GitHub 上仓库或组织的维护者和社区之间进行对话的开放论坛。如果您使用或贡献项目,您可以启动讨论以提出建议,并与维护者和社区成员就您的计划、问题、想法和反馈进行交流。有关更多信息,请参阅“关于讨论”。

所有讨论必须在某个类别中创建。对于仓库讨论,拥有仓库维护或管理员权限的人员可以为该仓库的讨论定义类别。对于组织讨论,拥有源仓库维护或管理员权限的人员可以为该组织的讨论定义类别。每个类别都有一个格式:开放式讨论、问答或公告。维护人员可以使用公告格式的类别来分享信息、发布或活动。为了使这些类别的讨论集中在重要更新上,只有拥有维护或管理员权限的人员才能创建新的讨论,但任何人都可以评论和回复。

仓库管理员和项目维护人员可以删除该仓库中的讨论。同样,组织讨论的源仓库管理员和维护人员可以删除该组织中的讨论。有关更多信息,请参阅“管理讨论”。

GitHub 会自动识别在问答格式的讨论中贡献最多被标记为答案的评论的社区成员。这些成员将出现在项目讨论中最有帮助的贡献者列表中,前提是他们的隐私设置允许。有关更多信息,请参阅“将您的个人资料设置为私有”。

随着项目的增长,您可以授予社区活跃成员更高的访问权限。有关更多信息,请参阅“授予顶级贡献者更高的权限”。

Screenshot of the "Discussions" page in a repository. The "Most helpful" section is outlined in dark orange.

社区成员可以点赞讨论和讨论中的顶级评论,以与维护人员沟通他们关心的想法。项目维护人员随后可以根据点赞对讨论和评论进行排序,以了解社区成员重视的内容。

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

先决条件

要与仓库讨论中的维护人员进行协作,仓库管理员或项目维护人员必须为仓库启用 GitHub Discussions。有关更多信息,请参阅“为仓库启用或禁用 GitHub Discussions”。

要与组织讨论中的维护人员进行协作,必须为组织启用 GitHub Discussions。有关更多信息,请参阅“为组织启用或禁用 GitHub Discussions”。

开始讨论

  1. 在 GitHub.com 上,导航到您要开始讨论的仓库或组织的主页。

  2. 在您的仓库或组织名称下,点击 讨论.

    Screenshot of the tabs in a GitHub repository. The "Discussions" option is outlined in dark orange.

  3. 在页面右侧,点击 **新建讨论**。

  4. 通过点击 **开始** 选择一个讨论类别。

    Screenshot of the "Select a discussion category" page.  A button, labeled "Get started", is outlined in dark orange.

  5. 在“讨论标题”下,输入您的讨论标题,并在“撰写”下,输入您的讨论内容。

    Screenshot of the text fields for the title and body for a new discussion.

  6. 点击 **开始讨论**。

开始投票

  1. 在 GitHub.com 上,导航到仓库的主页。

  2. 在您的仓库或组织名称下,点击 讨论.

    Screenshot of the tabs in a GitHub repository. The "Discussions" option is outlined in dark orange.

  3. 在类别列表中,点击 **投票**。

    Screenshot of the categories section in the "Discussions" tab. The "Poll" category is outlined in dark orange.

  4. 在右侧,点击 **新建讨论**。

  5. 在“讨论标题”下,输入标题,并在“撰写”下,可选地输入投票内容。

    Screenshot of the page to start a new poll.

  6. 在“投票问题”下,输入您的投票问题。

  7. 在“投票选项”下,输入至少两个投票选项。

  8. 可选地,要添加额外的投票选项,点击 ** 添加选项**。

    Screenshot of the page to start a new poll. The plus icon and "Add an option" are outlined in dark orange.

  9. 点击 **开始投票**。

筛选讨论列表

您可以搜索讨论并筛选仓库或组织中的讨论列表。有关更多信息,请参阅“搜索讨论”。

  1. 在 GitHub.com 上,导航到仓库或组织的主页。

  2. 在您的仓库或组织名称下,点击 讨论.

    Screenshot of the tabs in a GitHub repository. The "Discussions" option is outlined in dark orange.

  3. 在 **搜索所有讨论** 字段中,输入搜索查询。可选地,在搜索字段右侧,点击按钮以进一步筛选结果。

    Screenshot of the search bar and buttons for filtering discussions.

  4. 在讨论列表中,点击您要查看的讨论。

排序讨论列表

您可以选择如何排序讨论列表。

  1. 在 GitHub.com 上,导航到仓库或组织的主页。

  2. 在您的仓库或组织名称下,点击 讨论.

    Screenshot of the tabs in a GitHub repository. The "Discussions" option is outlined in dark orange.

  3. 在 **搜索所有讨论** 字段的右侧,选择 **排序方式** 下拉菜单,然后点击一个时间段。

    Screenshot of a row of buttons for sorting discussions. A button labeled "Sort by: Latest activity" is highlighted with an orange outline.

    • 按 **最新活动** 排序,以显示活动最新的讨论,并将其置于列表顶部。
    • 按 **创建日期** 排序,以显示最近创建的讨论,并将其置于列表顶部。
    • 按 **热门** 排序,以显示获得最多点赞的讨论,并将其置于列表顶部。您可以将列表限制为仅显示特定时间段内的讨论。

对讨论中的顶级评论进行排序

您可以选择如何对讨论中的顶级评论进行排序。评论线程不会影响评论的排序顺序。

  1. 在 GitHub.com 上,导航到仓库或组织的主页。

  2. 在您的仓库或组织名称下,点击 讨论.

    Screenshot of the tabs in a GitHub repository. The "Discussions" option is outlined in dark orange.

  3. 在讨论列表中,点击您要查看的讨论。

  4. 在主要讨论帖子下方,选择 **最旧**、**最新** 或 **热门**。

    Screenshot of a discussion. The buttons for sorting comments in discussions are outlined in dark orange.

    • 按 **最旧** 排序,以显示最旧的顶级评论。
    • 按 **最新** 排序,以显示最新的顶级评论。
    • 按 **热门** 排序,以显示获得最多点赞的顶级评论。

将问题转换为讨论

如果问题实际上是一个问题或开放式对话,而不是要跟踪和优先处理的工作项,则可以将问题转换为讨论。有关更多信息,请参阅 "管理讨论"。

进一步阅读