跳至主要内容

使用讨论与维护者协作

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

谁可以使用此功能?

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

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

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

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

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

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

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

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

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

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

先决条件

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

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

发起讨论

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

  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 上,导航到仓库的主页。

  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 上,导航到仓库或组织的主页。

  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 上,导航到仓库或组织的主页。

  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 上,导航到仓库或组织的主页。

  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.

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

将问题转换为讨论

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

进一步阅读