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 ou organização de um projeto e coletar diversas sugestões e ideias mais rapidamente. Você pode ajudar a dirigir uma conversa produtiva de várias maneiras.

  • Fazendo pontuais e perguntas complementares para obter feedback específico
  • Capturar uma experiência diversificada e sintetizá-la para os pontos principais
  • Abrir 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 direção a 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
  • Você deverá o interesse em novas ideias e medir a opinião da comunidade usando enquetes

Você pode usar discussões no repositório para discutir tópicos específicos do repositório. Se o seu projeto abrange vários repositórios, você poderá usar discussões da organização para discutir tópicos que não sejam específicos de um único repositório na sua organização.

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".

Seguindo as diretrizes de contribuição

Antes de abrir uma discussão em um repositório de código aberto, 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