Skip to main content

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.

Who can use this feature

People with read access to a repository can start and participate in discussions and polls in the repository. People with read access to the source repository for organization discussions can start and participate in discussions and polls in the organization.

About collaboration with maintainers using GitHub Discussions

O GitHub Discussions é um fórum aberto para conversa entre mantenedores e a comunidade de um projeto no 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."

Todas as discussões devem ser criadas em uma categoria. Para discussões do repositório, as pessoas com permissões de manutenção ou administrador no repositório definem as categorias para discussões nesse repositório. Para discussões da organização, as pessoas com permissões de manutenção ou administrador no repositório de origem definem as categorias para discussões nessa organização. Cada categoria tem um formato: discussão aberta, pergunta e resposta ou anúncio. Os mantenedores podem usar categorias com o formato do anúncio para compartilhar informações, versões ou eventos. Para manter as discussões nessas categorias focadas em atualizações importantes, apenas pessoas com permissões de manutenção ou administração podem criar novas discussões, mas qualquer pessoa pode comentar e responder.

Repository administrators and project maintainers can delete a discussion in that repository. Similarly, administrators and maintainers of the source repository for an organization's discussions can delete a discussion in that organization. For more information, see "Managing discussions."

GitHub reconhecerá automaticamente os integrantes da comunidade que contribuem com a maioria dos comentários marcados como respostas para discussões com um formato de pergunta/resposta. 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"

Most helpful contributors to discussions for a project

Community members can upvote discussions and top-level comments inside discussions to communicate with maintainers about ideas that matter to them. Project maintainers can then sort discussions and comments based on upvotes to gain insight into what community members value.

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

Prerequisites

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

To collaborate with maintainers in organization discussions, GitHub Discussions must be enabled for the organization. For more information, see "Enabling or disabling GitHub Discussions for an organization."

Starting a discussion

  1. On GitHub.com, navigate to the main page of the repository or organization where you want to start a discussion.
  2. No nome de seu repositório ou organização, clique em Discussões. Guia "Discussões" de um repositório
  3. Click New discussion. "New discussion" button within the "Discussions" tab for a repository
  4. Select the Select Category drop-down menu, and click a category for your discussion. "Select Category" drop-down menu and list of available categories in a repository
  5. Type a title and body for your discussion. Text fields for new discussion's title and body
  6. Click Start discussion. "Start discussion" button

Starting a poll

  1. On GitHub.com, navigate to the main page of the repository. 1. No nome de seu repositório ou organização, clique em Discussões. Guia "Discussões" de um repositório
  2. Na lista de categorias, clique em Votações. Captura de tela mostrando a categoria "Votação"
  3. À direita, clique em Iniciar votação. Captura de tela mostrando o botão "Iniciar votação"
  4. Digite um título e um corpo opcional para sua votação. Captura de tela mostrando campos de texto para título e corpo
  5. Digite uma pergunta para sua votação. Captura de tela mostrando campos de texto para a pergunta da votação
  6. Digite pelo menos duas opções para a votação. Captura de tela mostrando campos de texto para as opções da votação
  7. Opcionalmente, para adicionar uma opção de votação extra, clique em Adicionar uma opção. Captura de tela mostrando o botão "Adicionar uma opção"
  8. Clique em Iniciar votação. Captura de tela mostrando o botão "Iniciar votação"

Filtering the list of discussions

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

  1. On GitHub.com, navigate to the main page of the repository or organization.
  2. No nome de seu repositório ou organização, clique em Discussões. Guia "Discussões" de um repositório
  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. Search bar and buttons for filtering discussions
  4. In the list of discussions, click the discussion you want to view. Discussion search results

Sorting the list of discussions

You can choose how to sort the list of discussions.

  1. On GitHub.com, navigate to the main page of the repository or organization.

  2. No nome de seu repositório ou organização, clique em Discussões. Guia "Discussões" de um repositório

  3. To the right of the Search all discussions field, select New, or select Top and choose a time period from the drop down menu.

    Buttons for sorting discussions

    • Sort by New to display the discussions with the most recent activity at the top of the list.
    • Sort by Top to display the discussions with the most upvotes at the top of the list. You can limit the list to only display discussions from a specific time period.

Sorting top-level comments in discussions

You can choose how to sort top-level comments in discussions. Comment threads do not impact the order comments are sorted in.

  1. On GitHub.com, navigate to the main page of the repository or organization.

  2. No nome de seu repositório ou organização, clique em Discussões. Guia "Discussões" de um repositório

  3. Na lista de discussões, clique na discussão que você deseja visualizar. Discussão na lista de discussões de um repositório

  4. Under the main discussion post, select Oldest, Newest, or Top.

    Buttons for sorting comments in discussions

    • Sort by Oldest to display the oldest top-level comments first.
    • Sort by Newest to display the newest top-level comments first.
    • Sort by Top to display the most upvoted top-level comments first.

Converting an issue to a discussion

Se um problema for uma pergunta ou conversa aberta em vez de um item de trabalho para rastrear e priorizar, você poderá converter o problema em uma discussão. For more information, see "Moderating discussions."

Further reading