About discussions

Use discussions to ask and answer questions, share information, make announcements, and conduct or participate in a conversation about a project on GitHub.

About GitHub Discussions

With GitHub Discussions, the community for your project can create and participate in conversations within the project's repository. Discussions empower a project's maintainers, contributors, and visitors to gather and accomplish the following goals in a central location, without third-party tools.

  • Share announcements and information, gather feedback, plan, and make decisions
  • Ask questions, discuss and answer the questions, and mark the discussions as answered
  • Foster an inviting atmosphere for visitors and contributors to discuss goals, development, administration, and workflows

Discussions tab for a repository

You don't need to close a discussion like you close an issue or a pull request.

If a repository administrator or project maintainer enables GitHub Discussions for a repository, anyone who visits the repository can create and participate in discussions for the repository. Repository administrators and project maintainers can manage discussions and discussion categories in a repository, and pin discussions to increase the visibility of the discussion. Moderators and collaborators can mark comments as answers, lock discussions, and convert issues to discussions. For more information, see "Repository roles for an organization."

For more information about management of discussions for your repository, see "Managing discussions in your repository."

About discussion organization

You can organize discussions with categories and labels.

您可以对讨论进行分类,以帮助社区成员在正确的位置开始对话,并帮助社区成员查找相关的讨论。 所有讨论都必须在类别中创建。 拥有维护或管理权限的人定义仓库的类别。 每个类别都有一个格式:开放式讨论、问答或公告。 每个仓库最多可以有 10 个类别。

For discussions with a question/answer format, an individual comment within the discussion can be marked as the discussion's answer. GitHub 将自动识别贡献最多评论的社区成员,将评论标记为问题/回答格式的讨论答案。

维护者可以使用通知格式的类别来分享信息、发布或事件。 为了使这些类别的讨论集中于重要的更新,只有拥有维护或管理权限的人才可创建新的讨论,但任何人都可以评论和回复。

For more information, see "Managing categories for discussions in your repository."

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

Best practices for GitHub Discussions

As a community member or maintainer, start a discussion to ask a question or discuss information that affects the community. For more information, see "Collaborating with maintainers using discussions."

Participate in a discussion to ask and answer questions, provide feedback, and engage with the project's community. For more information, see "Participating in a discussion."

You can spotlight discussions that contain important, useful, or exemplary conversations among members in the community. For more information, see "Managing discussions in your repository."

如果议题原来是问题或开放式对话,而不是要跟踪和确定优先级的工作项,则您可以将议题转换为讨论。 For more information, see "Moderating discussions in your repository."

Sharing feedback

You can share your feedback about GitHub Discussions with GitHub. To join the conversation, see github/feedback.

Further reading




所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。


或者, 了解如何参与。