Skip to main content

Sobre discussões

Use discussões para fazer e responder perguntas, compartilhar informações, fazer anúncios e conduzir ou participar de uma conversa sobre um projeto em GitHub Enterprise Cloud.

Sobre o GitHub Discussions

Com GitHub Discussions, a comunidade do seu projeto pode criar e participar de conversas no repositório do projeto ou na organização. As discussões capacitam os mantenedores, contribuidores e visitantes para reunirem e atingirem os objetivos seguintes em um local central, sem ferramentas de terceiros.

  • Compartilhar anúncios e informações, recolher feedback, planejar e tomar decisões
  • Faça perguntas, discuta e responda às perguntas, e marque as discussões como respondidas
  • Criar pesquisas para avaliar a opinião da comunidade
  • Promova uma atmosfera convidativa para visitantes e contribuidores para discutir objetivos, desenvolvimento, administração e fluxos de trabalho

Aba de discussões para um repositório

Você pode usar discussões de repositório para falar sobre tópicos específicos do repositório. Se o projeto abrange vários repositórios, você pode usar discussões de organização para conversar sobre tópicos que não são específicos de um único repositório em sua organização.

Você não precisa fechar uma discussão como você fecha um problema ou um pull request.

Se um administrador de repositório ou mantenedor do projeto habilitar GitHub Discussions para um repositório, qualquer pessoa que tiver acesso ao repositório poderá criar e participar de discussões do repositório. Se um proprietário da organização habilitar GitHub Discussions em uma organização, qualquer pessoa que possa exibir o repositório de origem poderá criar uma discussão da organização.

Os administradores de repositório e mantenedores de projetos podem gerenciar as discussões e categorias de discussão em um repositório e fixar discussões para aumentar a visibilidade da discussão. Os moderadores e colaboradores podem marcar comentários como respostas, travar discussões e converter problemas em discussões. Da mesma forma, para discussões de organização, a função de um usuário no repositório de origem determina como um usuário pode interagir com as discussões da organização. Para obter mais informações, confira "Funções de repositório de uma organização".

Para obter mais informações sobre o gerenciamento de discussões, confira "Gerenciar discussões".

Sobre pesquisas

Você pode criar pesquisas na categoria de pesquisas para avaliar o interesse em novas ideias e na direção do projeto. Qualquer pessoa com acesso de leitura ao seu repositório pode criar pesquisas, votar em pesquisas e exibir os resultados delas. Os usuários desconectados podem ver os resultados das pesquisas em repositórios públicos.

As pesquisas exigem uma pergunta e pelo menos duas opções. Você pode adicionar no máximo oito opções e as opções podem conter no máximo 128 caracteres.

Os votantes não podem mudar o voto. A edição de uma pesquisa redefinirá todos os votos que já foram feitos.

Para obter mais informações sobre como criar pesquisas, veja "Como criar uma pesquisa".

Sobre a organização de discussão

Você pode organizar discussões com categorias e etiquetas.

Você pode categorizar as discussões para ajudar os integrantes da comunidade a iniciar as conversas no lugar certo e para ajudar os integrantes da comunidade a encontrar as discussões relacionadas. 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. Cada repositório ou organização pode ter até 10 categorias.

Para discussões com um formato de pergunta/resposta, é possível marcar um comentário individual dentro da discussão como a resposta da discussão. 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.

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.

Para obter mais informações, confira "Gerenciar categorias para discussões".

Para organizar as discussões de forma mais granular, você pode aplicar etiquetas. Por exemplo, você pode usar etiquetas para indicar o status de uma discussão para tornar a triagem mais eficiente. Cada repositório tem um conjunto compartilhado de etiquetas para problemas, pull requests e discussões. Para obter mais informações, confira "Como gerenciar rótulos".

Práticas recomendadas para GitHub Discussions

Como integrante ou mantenedor da comunidade, inicie uma discussão para fazer uma pergunta ou discutir informações que afetem a comunidade. Para obter mais informações, confira "Colaboração com mantenedores por meio de discussões".

Participe de uma discussão para fazer e responder a perguntas, fornecer feedback e envolver-se com a comunidade do projeto. Para obter mais informações, confira "Como participar de uma discussão".

Você pode destacar discussões que contenham conversas importantes, úteis ou exemplares entre os integrantes da comunidade. Para obter mais informações, confira "Gerenciar discussões".

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. Para obter mais informações, confira "Como moderar discussões".

Compartilhando feedback

Você pode compartilhar seus comentários sobre GitHub Discussions com GitHub. Para participar da conversa, confira as discussões sobre GitHub Community.

Leitura adicional