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
- Vote a favor de discussões e comentários para dar maior visibilidade às ideias que você acha valiosas
- Promova uma atmosfera convidativa para visitantes e contribuidores para discutir objetivos, desenvolvimento, administração e fluxos de trabalho
Você pode usar discussões de repositório para falar sobre tópicos específicos do repositório. Se o projeto abranger vários repositórios, você poderá usar discussões da organização para debater tópicos que não são específicos de um único repositório em sua organização.
Você pode fechar uma discussão quando a discussão foi resolvida, não é mais relevante ou é uma duplicata. Para obter mais informações, confira Como encerrar uma discussão.
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 saber mais, confira Funções de repositório para uma organização.
Para obter mais informações sobre o gerenciamento de discussões, confira Gerenciando 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, confira Participando de uma discussão.
Sobre a organização de discussão
Você pode organizar as discussões com categorias, seções e rótulos.
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é 25 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 organizar ainda mais suas discussões, você pode criar seções e aninhar as categorias em uma seção.
Para saber mais, 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 "Gerenciar etiquetas".
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 saber mais, confira Colaboração com mantenedores usando as discussões.
Participe de uma discussão para fazer e responder a perguntas, fornecer feedback e envolver-se com a comunidade do projeto. Para saber mais, confira Participando de uma discussão.
Você pode destacar discussões que contenham conversas importantes, úteis ou exemplares entre os integrantes da comunidade. Para saber mais, confira Gerenciando 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 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.