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 Criar um problema.
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 saber mais, confira Sobre issues. As pull requests permitem comentar diretamente nas alterações propostas. Para saber mais, confira Sobre solicitação de pull e Fazer comentários em uma pull request.
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 saber mais, confira Configurar 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 Início Rápido para Discussões do GitHub.