O GitHub é uma plataforma colaborativa

  • 8 minutos

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, que é uma maneira de acompanhar as alterações feitas no seu projeto.

Nesta unidade, estamos aprendendo sobre problemas e discussões. Esses são dois outros elementos que contribuem para a natureza colaborativa da plataforma GitHub Enterprise.

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.

Neste tutorial, veremos como criar um problema a partir de um repositório. Mas os problemas também podem ser criados a partir de:

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

Criar um problema a partir de um repositório

  1. No GitHub, acesse a página principal do repositório.

  2. No nome do repositório, selecione Problemas.

    Captura de tela mostrando a parte superior da página principal de um repositório com a seção Problemas destacada.

  3. Selecione Novo problema.

  4. Se o seu repositório usar modelos de problemas, ao lado do tipo de problema que você deseja 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. Se não estiver usando modelos, pule para a Etapa 5.

    Captura de tela do menu de modelos de problemas, com a opção Abrir um problema em branco destacada.

  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 de projetos, associá-lo a um marco ou aplicar um rótulo.

  8. 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.

Nessa seção, abordamos:

  • Habilitando uma discussão em seu repositório.
  • Criar uma 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.

  1. No GitHub, acesse a página principal do repositório.

  2. No nome do seu repositório, selecione Configurações.

    Captura de tela da parte superior da página principal de um repositório com a seção Configurações destacada.

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

    Captura de tela da caixa de Discussões com o botão verde Configurar discussão destacado.

  4. 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.

  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 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.

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

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

    Captura de tela da parte superior da página principal de um repositório com a seção Discussões destacada.

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

  4. 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.

    Uma captura de tela da seleção do menu Selecionar uma categoria de discussão, com a opção superior Anúncios e o botão Introdução destacados.

Cada categoria deve ter um nome exclusivo, emparelhamento de emojis e uma descrição detalhada que indique seu propósito. As categorias ajudam os mantenedores a organizar como as conversas são arquivadas. Elas são personalizáveis para ajudar a diferenciar categorias que são de 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

  1. 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.

    Captura de tela da página de início de uma nova discussão, com a caixa de título da discussão e a caixa de conteúdo vazias.

  2. 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.