Práticas recomendadas para conversas comunitárias no GitHub

Você pode usar discussões para fazer um problema com sua equipe, e, finalmente, mover a conversa para uma discussão quando você estiver pronto para determinar o escopo do trabalho.

Conversas comunitárias 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. As discussões são úteis para as 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."

Seguir 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

Esse documento ajudou você?Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.