# GitHub Discussions documentation

GitHub Discussions is a collaborative communication forum for the community around an internal project. Community members can ask and answer questions, share updates, have open-ended conversations, and follow along on decisions affecting the community's way of working.

## Recommended

* [Quickstart for GitHub Discussions](/en/discussions/quickstart)

  Enable GitHub Discussions on an existing repository or organization and start conversations with your community.

* [About discussions](/en/discussions/collaborating-with-your-community-using-discussions/about-discussions)

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

* [Best practices for community conversations on GitHub](/en/discussions/guides/best-practices-for-community-conversations-on-github)

  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.

* [Participating in a discussion](/en/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion)

  You can converse with the community and maintainers in a forum within the repository for a project on GitHub.

* [Moderating discussions](/en/discussions/managing-discussions-for-your-community/moderating-discussions)

  You can promote healthy collaboration by marking comments as answers, locking or unlocking discussions, converting issues to discussions, and editing or deleting comments, discussions, and categories that don't align with your organization's contribution guidelines.

* [Managing categories for discussions](/en/discussions/managing-discussions-for-your-community/managing-categories-for-discussions)

  You can categorize discussions to organize conversations for your community members, and you can choose a format for each category.

## Links

### Getting started

* [Quickstart for GitHub Discussions](/en/discussions/quickstart)

  Enable GitHub Discussions on an existing repository or organization and start conversations with your community.

* [About discussions](/en/discussions/collaborating-with-your-community-using-discussions/about-discussions)

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

## Articles

* [Quickstart for GitHub Discussions](/en/discussions/quickstart)

  Enable GitHub Discussions on an existing repository or organization and start conversations with your community.

* [Best practices for community conversations on GitHub](/en/discussions/guides/best-practices-for-community-conversations-on-github)

  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.

* [Finding your discussions](/en/discussions/guides/finding-your-discussions)

  You can easily access every discussion you've created or participated in.

* [Granting higher permissions to top contributors](/en/discussions/guides/granting-higher-permissions-to-top-contributors)

  Repository administrators can promote any community member to a moderator and maintainer.

* [About discussions](/en/discussions/collaborating-with-your-community-using-discussions/about-discussions)

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

* [Participating in a discussion](/en/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion)

  You can converse with the community and maintainers in a forum within the repository for a project on GitHub.

* [Collaborating with maintainers using discussions](/en/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions)

  You can contribute to the goals, plans, health, and community for a project on GitHub by communicating with the maintainers of the project in a discussion.

* [Managing discussions](/en/discussions/managing-discussions-for-your-community/managing-discussions)

  You can categorize, spotlight, transfer, or delete the discussions.

* [Managing categories for discussions](/en/discussions/managing-discussions-for-your-community/managing-categories-for-discussions)

  You can categorize discussions to organize conversations for your community members, and you can choose a format for each category.

* [Moderating discussions](/en/discussions/managing-discussions-for-your-community/moderating-discussions)

  You can promote healthy collaboration by marking comments as answers, locking or unlocking discussions, converting issues to discussions, and editing or deleting comments, discussions, and categories that don't align with your.

* [Viewing insights for your discussions](/en/discussions/managing-discussions-for-your-community/viewing-insights-for-your-discussions)

  Discussions insights provide data about your discussions' activity, views, and contributors.

* [Creating discussion category forms](/en/discussions/managing-discussions-for-your-community/creating-discussion-category-forms)

  You can customize the templates that are available for community members to use when they open new discussions in your repository.

* [Syntax for discussion category forms](/en/discussions/managing-discussions-for-your-community/syntax-for-discussion-category-forms)

  You can use YAML syntax to define the fields in your discussion category forms.