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 seja de código para o repositório ou a organização de um projeto e coletar diversos comentários e ideias mais rapidamente. Você pode ajudar a conduzir uma conversa produtiva de várias maneiras.

  • Fazendo pontuais e perguntas complementares para obter feedback específico
  • Captura de uma experiência diversificada e sua destilação até os pontos principais
  • Abertura de um problema para tomada de ações com base na conversa, quando aplicável

Para obter mais informações sobre como abrir um problema e fazer referência cruzada a uma discussão, confira "Como abrir um problema por meio 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 em inúmeros cenários.

  • 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ê quer medir o interesse em novas ideias e avaliar a opinião da comunidade usando votações

Você pode usar discussões de repositório para debater 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.

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, confira "Sobre os problemas". As pull requests permitem comentar diretamente nas alterações propostas. Para obter mais informações, confira "Sobre as solicitações de pull" e "Como adicionar comentários a uma solicitação de pull".

Seguindo as diretrizes de contribuição

Antes de abrir uma discussão em um repositório, verifique se o repositório tem diretrizes de colaboraçã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, confira "Como configurar seu projeto para contribuições úteis".

Próximas etapas

Para continuar aprendendo sobre o GitHub Discussions e criar rapidamente uma discussão para sua comunidade, confira "Guia de Início Rápido do GitHub Discussions".

Leitura adicional