GitHub é uma plataforma colaborativa

A colaboração está no centro de tudo o que o GitHub faz. Analisamos os 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 solicitações pull, que é uma maneira de acompanhar as alterações feitas no seu projeto.

Nesta unidade, estamos aprendendo sobre questões e discussões. Esses são recursos que contribuem para a natureza colaborativa da Plataforma Empresarial GitHub.

Problemas

Os problemas do GitHub são usados para rastrear ideias, feedback, tarefas ou bugs para o trabalho no GitHub. Os problemas podem ser criados de várias maneiras, para que você possa escolher o método mais conveniente para seu fluxo de trabalho.

Este passo a passo aborda como criar um problema a partir de um repositório. Os problemas também podem ser criados a partir de:

• Um item em uma lista de tarefas.
• Uma nota num projeto.
• Um comentário em um problema ou solicitação pull.
• Uma linha de código específica.
• Uma consulta de URL.

Criando um problema a partir de um repositório

1. No GitHub.com, navegue até a página principal do repositório.

2. Sob o nome do repositório, selecione Problemas.

   

3. Selecione Novo problema.

4. Se o repositório usar modelos de problema, ao lado do tipo de problema que você deseja abrir, selecione Introdução.

   Se o tipo de problema que pretende abrir não estiver incluído nas opções disponíveis, selecione Abrir um problema em branco. Se não estiver usando modelos, pule para a Etapa 5.

   Se o repositório usar formulários de problema, você verá um formulário estruturado para preencher em vez de um modelo de problema em branco. Os formulários de emissão permitem que os mantenedores coletem informações específicas em um formato padronizado.

   

5. No campo Adicionar um título , insira um título para o seu problema.

6. No campo Adicionar uma descrição , digite uma descrição do problema.

7. Se você for um mantenedor de projeto, poderá atribuir o problema a alguém, adicioná-lo a um quadro do projeto, associá-lo a uma etapa ou aplicar um rótulo.

8. Quando terminar, selecione Enviar novo problema.

Use rótulos, menções e reações para gerenciar a colaboração de forma eficaz e aumentar a visibilidade do problema. Os modelos de problemas ajudam a manter uma estrutura e expectativas consistentes para os contribuidores.

Algumas conversas podem ser mais apropriadas para discussões no GitHub. Use as Discussões do GitHub 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, analisaremos Discussões e como utilizar melhor o recurso.

Debates

As discussões são projetadas para conversas que não estão necessariamente vinculadas ao código, como perguntas e respostas, ideias ou feedback geral. Eles suportam comunicação aberta e contínua dentro de um fórum compartilhado e podem ser públicos ou privados, dependendo da visibilidade do repositório.

Nesta secção, irá aprender a:

• Habilitando uma discussão em seu repositório.
• Criação de uma nova discussão e várias categorias de discussão.

Vamos nos aprofundar para habilitar uma discussão em seu repositório.

Ativando uma discussão em seu repositório

Os proprietários de repositórios e aqueles com acesso de gravação podem habilitar as discussões do GitHub para uma comunidade em seus repositórios públicos e privados. A visibilidade de uma discussão herda a visibilidade do repositório em que ela foi criada.

Ao ativar as Discussões do GitHub pela primeira vez, você será solicitado a configurar uma postagem de boas-vindas.

1. No GitHub.com, navegue até a página principal do repositório.

2. Sob o nome do repositório, selecione Configurações.

   

3. Role para baixo até a seção Recursos e, em Discussões, selecione Configurar discussões.

   

4. Em Iniciar uma nova discussão, edite o modelo para corresponder ao tom e aos recursos da sua comunidade.

5. 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 o repositório pode criar uma discussão nesse repositório. Para discussões no nível da organização, qualquer usuário que possa visualizar o repositório de origem também pode criar uma discussão.

1. No GitHub.com, navegue até a página principal do repositório ou da organização onde deseja iniciar uma discussão.

2. Sob o nome do repositório ou da organização, selecione Discussões.

   

3. No lado direito da página, selecione Nova discussão.

4. Selecione uma categoria de discussão escolhendo Introdução. Todas as discussões devem ser colocadas em uma categoria. Os mantenedores do repositório definem essas categorias.

   

Cada categoria de discussão inclui um nome, emoji e descrição exclusivos para esclarecer seu propósito. As categorias ajudam os mantenedores a organizar como as conversas são arquivadas. Eles são personalizáveis para ajudar a distinguir 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.

Os mantenedores do repositório podem fixar discussões importantes na parte superior da guia Discussões para melhor visibilidade.

1. Em Título da discussão , introduza um título para a discussão e, em Escrever , introduza o corpo da discussão.

   

2. Selecione Iniciar discussão.

Isso aborda como o GitHub suporta a colaboração por meio de questões e discussões. Agora vamos passar para como você pode gerenciar notificações, assinar threads e começar a usar as páginas do GitHub.

Marcar um comentário como resposta

Em uma discussão no estilo P&R, você pode marcar um comentário como a resposta aceita para a pergunta original.

1. Navegue até a discussão.
2. Localize o comentário que melhor responde à pergunta original.
3. Selecione Marcar como resposta abaixo do comentário.

O comentário será destacado, tornando mais fácil para os outros encontrarem a solução rapidamente. Você também pode desmarcar uma resposta, se necessário.

Convertendo uma discussão em um problema

Se uma discussão levar a um trabalho que precisa ser rastreado, você pode converter a discussão em um problema.

1. Navegue até a discussão que deseja converter.
2. Selecione o ... menu (três pontos) no canto superior direito da discussão.
3. Selecione Converter em problema.
4. Confirme a conversão e selecione um repositório para criar o novo problema.

Isso acompanha o trabalho acionável que se origina de conversas da comunidade.

Afixar uma discussão

Você pode fixar discussões importantes na parte superior da página Discussões para melhor visibilidade.

1. Navegue até a discussão que deseja fixar.
2. Selecione o ... menu (três pontos) no canto superior direito da discussão.
3. Selecione Fixar discussão.

As discussões fixas são úteis para destacar anúncios, perguntas importantes ou tópicos contínuos que a comunidade deve notar.