Skip to main content

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 or organization. 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
  • Create polls to gauge community opinion
  • Foster an inviting atmosphere for visitors and contributors to discuss goals, development, administration, and workflows

Discussions tab for a repository

You might use repository discussions to discuss topics that are specific to the repository. If your project spans multiple repositories, you might use organization discussions to discuss topics that aren't specific to a single repository in your organization.

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. If an organization owner enables GitHub Discussions for an organization, anyone who can view the source repository can create an organization discussion.

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. Similarly, for organization discussions, the role of a user in the source repository determines how a user can interact with organization discussions. For more information, see "Repository roles for an organization."

For more information about management of discussions, see "Managing discussions."

About polls

You can create polls in the polls category to gauge interest in new ideas and project direction. Anyone with read access to your repository can create polls, vote in polls, and view their results. Logged out users can view the results of polls in public repositories.

Polls require a question and at least two options. You can add a maximum of eight options and the options can contain a maximum of 128 characters.

Voters cannot change their vote. Editing a poll will reset any votes that have already been cast.

For more information on creating polls, see "Creating a poll."

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."

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

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."

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

Sharing feedback

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

Further reading