Collaborating with maintainers using discussions

About collaboration with maintainers using discussions

Discussions are an open forum for conversation among maintainers and the community for a project on GitHub. If you use or contribute to a project, you can start a discussion to make suggestions and engage with maintainers and community members about your plans, questions, ideas, and feedback. For more information, see "‎About discussions."

All discussions must be created in a category, and repository administrators and maintainers define the categories for a repository. Categories can contain open-ended conversations, or conversations with a question/answer format. Repository administrators and project maintainers can delete a discussion. For more information, see "Managing discussions in your repository."

GitHub will automatically recognize community members who contribute the most comments marked as answers to discussions with a question/answer format. These members appear in a list of the most helpful contributors to the project's discussions. As your project grows, you can grant higher access permissions to active members of your community. For more information, see "Granting higher permissions to top contributors"

For more information about participation in discussions, see "Participating in a discussion."

Prerequisites

To collaborate with maintainers using discussions, a repository administrator or project maintainer must enable discussions for the repository. For more information, see "Enabling or disabling discussions for a repository."

Starting a discussion

1. On GitHub, navigate to the main page of the repository.
2. Under your repository name, click Discussions.
   
3. Click New discussion.
   
4. Select the Select Category drop-down menu, and click a category for your discussion.
   
5. Type a title and body for your discussion.
   
6. Click Start discussion.
   

Filtering the list of discussions

You can search for discussions and filter the list of discussions in a repository. For more information, see "Searching discussions."

1. On GitHub, navigate to the main page of the repository.
2. Under your repository name, click Discussions.
   
3. In the Search all discussions field, type a search query. Optionally, to the right of the search field, click a button to further filter the results.
   
4. In the list of discussions, click the discussion you want to view.
   

Converting an issue to a discussion

If an issue turns out to be a question or open-ended conversation instead of a work item to track and prioritize, you can convert the issue to a discussion. For more information, see "Moderating discussions in your repository."

Further reading

• "About writing and formatting on GitHub"
• "Maintaining your safety on GitHub"