Skip to main content

Práticas recomendadas para conversas comunitárias no GitHub

Você pode usar discussões para levantar hipóteses com a sua equipe e, por fim, transferir a conversa para um problema quando você estiver pronto para definir o escopo do trabalho.

Conversas da comunidade em GitHub Discussions

Como GitHub Discussions é um fórum aberto, há a oportunidade de trazer uma colaboração que não é do código para o repositório de um projeto e coletar diversas sugestões e ideias mais rapidamente. Você pode ajudar a conduzir uma conversa produtiva:

  • Fazendo pontuais e perguntas complementares para obter feedback específico
  • Capturando uma experiência diversificada e até os pontos principais
  • Abra um problema para tomar ações com base na conversa, quando aplicável

Para mais informações sobre como abrir um problema e fazer referências cruzadas a uma discussão, consulte "Abrir um problema a partir de um comentário".

Aprender sobre conversas no GitHub

Você pode criar e participar de discussões, problemas e pull requests, dependendo do tipo de conversa que você gostaria de ter.

Você pode usar GitHub Discussions para discutir o panorama geral, levantamento de hipóteses e desenvolver detalhes específicos de um projeto antes de vinculá-lo a um problema, que poderá ter o escopo definido. GitHub Discussions é útil para equipes se:

  • Você está na fase de descoberta de um projeto e ainda está aprendendo qual diretor sua equipe quer acessar
  • Você deseja coletar comentários de uma comunidade mais ampla sobre um projeto
  • Você deseja manter correções de erros, solicitações de recursos e conversas gerais separadas

Os problemas são úteis para discutir detalhes específicos de um projeto, como relatórios de erros e melhorias planejadas. Para obter mais informações, consulte "Sobre problemas". As pull requests permitem comentar diretamente nas alterações propostas. Para obter mais informações, consulte "Sobre pull requests" e "Comentar em uma pull request".

Na página da sua equipe você pode usar discussões de equipe para conversas que abrangem projetos ou repositórios que não pertencem a um problema ou pull request específico. Em vez de abrir uma issue em um repositório para discutir uma ideia, você pode incluir toda a equipe tendo uma conversa em uma discussão de equipe. Para obter mais informações, consulte "Sobre discussões de equipe."

Seguindo as diretrizes de contribuição

Antes de abrir uma discussão, verifique se o repositório tem diretrizes de contribuição. O arquivo CONTRIBUTING inclui informações sobre como o mantenedor do repositório gostaria que você contribuísse com ideias para o projeto.

Para obter mais informações, consulte "Configurando seu projeto para Contribuições Úteis."

Próximas etapas

Para continuar aprendendo sobre GitHub Discussions e criar rapidamente uma discussão para a sua comunidade, consulte "Começar rapidamente para GitHub Discussions.

Leia mais