{"meta":{"title":"Best practices for community conversations on GitHub","intro":"You can use discussions to brainstorm with your team, and eventually move the conversation to an issue when you are ready to scope out the work.","product":"GitHub Discussions","breadcrumbs":[{"href":"/en/discussions","title":"GitHub Discussions"},{"href":"/en/discussions/guides","title":"Guides"},{"href":"/en/discussions/guides/best-practices-for-community-conversations-on-github","title":"Best practices for community conversations"}],"documentType":"article"},"body":"# Best practices for community conversations on GitHub\n\nYou can use discussions to brainstorm with your team, and eventually move the conversation to an issue when you are ready to scope out the work.\n\n## Community conversations in GitHub Discussions\n\nSince GitHub Discussions is an open forum, there is an opportunity to bring non-code collaboration into a project's repository or organization and gather diverse feedback and ideas more quickly. You can help drive a productive conversation in a number of ways.\n\n* Asking pointed questions and follow-up questions to garner specific feedback\n* Capturing a diverse experience and distilling it down to main points\n* Opening an issue to take action based on the conversation, where applicable\n\nFor more information about opening an issue and cross-referencing a discussion, see [Creating an issue](/en/issues/tracking-your-work-with-issues/using-issues/creating-an-issue).\n\n## Learning about conversations on GitHub\n\nYou can create and participate in discussions, issues, and pull requests, depending on the type of conversation you'd like to have.\n\nYou can use GitHub Discussions to discuss big picture ideas, brainstorm, and develop a project's specific details before committing it to an issue, which can then be scoped. GitHub Discussions is useful for teams in a number of scenarios.\n\n* You are in the discovery phase of a project and are still learning which direction your team wants to go in.\n* You want to collect feedback from a wider community about a project.\n* You want to keep bug fixes, feature requests, and general conversations separate.\n* You want to measure interest in new ideas and gauge community opinion using polls.\n\nYou 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.\n\nIssues are useful for discussing specific details of a project such as bug reports and planned improvements. For more information, see [About issues](/en/issues/tracking-your-work-with-issues/learning-about-issues/about-issues). Pull requests allow you to comment directly on proposed changes. For more information, see [Pull requests](/en/pull-requests/reference/pull-requests) and [Commenting on a pull request](/en/pull-requests/how-tos/review-pull-requests/commenting-on-a-pull-request).\n\n## Following contributing guidelines\n\nBefore you open a discussion in a repository, check to see if the repository has contributing guidelines. The CONTRIBUTING file includes information about how the repository maintainer would like you to contribute ideas to the project.\n\nFor more information, see [Setting up your project for healthy contributions](/en/communities/setting-up-your-project-for-healthy-contributions).\n\n## Next steps\n\nTo continue learning about GitHub Discussions and quickly create a discussion for your community, see [Quickstart for GitHub Discussions](/en/discussions/quickstart).\n\n## Further reading\n\n* [Setting up your project for healthy contributions](/en/communities/setting-up-your-project-for-healthy-contributions)\n* [Using templates to encourage useful issues and pull requests](/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests)\n* [Moderating comments and conversations](/en/communities/moderating-comments-and-conversations)\n* [Writing on GitHub](/en/get-started/writing-on-github)"}