O GitHub é uma plataforma colaborativa
Como mencionamos anteriormente, a colaboração está no centro de tudo o que o GitHub faz.
Passamos por repositórios na primeira unidade do módulo e aprendemos que os repositórios ajudam você a organizar seu projeto e seus arquivos.
Na última unidade, aprendemos sobre pull requests, uma maneira de acompanhar as alterações feitas em seu projeto.
Nesta unidade, estamos aprendendo sobre questões e discussões, duas outras peças que contribuem para a natureza colaborativa da GitHub Enterprise Platform.
Problemas
Os problemas do GitHub foram criados para acompanhar ideias, comentários, tarefas ou bugs relacionados ao trabalho no GitHub.
Os problemas podem ser criados de várias maneiras, para que você possa escolher o método mais conveniente para o fluxo de trabalho.
Para o passo a passo na próxima parte, vamos examinar como criar um problema a partir de um repositório, mas apenas saiba que há muitas maneiras. Aqui está uma lista de todas as maneiras pelas quais você pode criar problemas.
As diferentes maneiras de criar um problema a partir de:
- um repositório
- um item em uma lista de tarefas
- uma anotação em um projeto
- um comentário em um problema ou pull request
- uma linha de código específica
- ou uma consulta de URL
Criar um problema a partir de um repositório
No GitHub, acesse a página principal do repositório.
No nome do repositório, selecione Problemas.
Selecione Novo problema.
Se o repositório usar modelos de problema, ao lado do tipo de problema que você gostaria de abrir, selecione Introdução.
Se o tipo de problema que você deseja criar não estiver incluído nas opções disponíveis, selecione Criar um problema em branco.
No campo Adicionar um título, insira um título para o seu problema.
No campo Adicionar uma descrição, digite uma descrição do problema.
Se você for um mantenedor de projeto, poderá atribuir o problema a alguém, adicioná-lo a um quadro de projetos, associá-lo a um marco ou aplicar um rótulo.
Quando terminar, selecione Enviar novo problema.
Algumas conversas são mais adequadas para o GitHub Discussions.
Você pode usar o GitHub Discussions para fazer e responder perguntas, compartilhar informações, fazer anúncios e conduzir ou participar de conversas sobre um projeto.
Na próxima seção, examinaremos as discussões e como utilizar melhor o recurso.
Discussões
As discussões se destinam a conversas que precisam ser acessíveis a todos e não estão relacionadas ao código. As discussões permitem uma conversa fluida e aberta em um fórum público.
Nesta seção, vamos examinar:
- Habilitar uma discussão em seu repositório
- Criar uma nova discussão e várias categorias de discussão
Vamos nos aprofundar em habilitar uma discussão em seu repositório.
Habilitar uma discussão em seu repositório
Os proprietários do repositório e as pessoas com acesso de gravação podem habilitar o GitHub Discussions para uma comunidade em seus repositórios públicos e privados. A visibilidade de uma discussão é herdada do repositório no qual a discussão é criada.
Ao habilitar o GitHub Discussions pela primeira vez, você será convidado a configurar um post de boas-vindas.
No GitHub, acesse a página principal do repositório.
No nome do seu repositório, selecione Configurações.
Role para baixo até a seção Recursos e, em Discussões, selecione Configurar as discussões.
Em Iniciar uma nova discussão, edite o modelo para se alinhar com os recursos e o tom que você deseja definir para a sua comunidade.
Selecione Iniciar discussão.
Agora você está pronto para criar uma nova discussão.
Criar uma nova discussão
Qualquer usuário autenticado que possa visualizar um repositório pode criar uma discussão nesse repositório.
Da mesma forma, como as discussões da organização são baseadas em um repositório de origem, qualquer usuário autenticado que possa exibir o repositório de origem pode criar uma discussão nessa organização.
No GitHub.com, navegue até a página principal do repositório ou organização em que você deseja iniciar uma discussão.
Em seu repositório ou nome da organização, selecione Discussões.
No lado direito da página, selecione Nova discussão.
Selecione uma categoria de discussão selecionando Introdução. Todas as discussões devem ser criadas em uma categoria. Para discussões do repositório, as pessoas com permissões de manutenção ou administrador no repositório definem as categorias para discussões nesse repositório.
Cada categoria deve ter um nome exclusivo e um emparelhamento de emoji, e uma descrição detalhada indicando sua finalidade. As categorias ajudam os mantenedores a organizar como as conversas são arquivadas e podem ser personalizadas para ajudar a distinguir as categorias que são perguntas e respostas ou conversas mais abertas. A tabela a seguir mostra as categorias padrão para discussões e sua finalidade.
Categoria | Finalidade | Formato |
---|---|---|
📣 Comunicados | Atualizações e notícias de mantenedores do projeto | Anúncio |
#️⃣ Geral | Tudo que for relevante para o projeto | Discussão aberta |
💡 Ideias | Ideias para alterar ou melhorar o projeto | Discussão aberta |
🗳️ Pesquisas | Pesquisas com várias opções para a comunidade votar e discutir | Pesquisas |
🙏 Perguntas e respostas | Perguntas para a comunidade responder, com um formato de pergunta/resposta | Pergunta e resposta |
🙌 Mostrar e contar | Criações, experimentos ou testes relevantes para o projeto | Discussão aberta |
No Título da discussão, insira um título para a sua discussão e, em Escrever, insira o corpo da sua discussão.
Selecione Iniciar discussão.
Isso aborda um pouco sobre como o GitHub inspira a colaboração. Agora vamos passar para como você pode gerenciar notificações, assinar threads e começar a usar as páginas do GitHub.