Olá, Mundo

Siga este exercício de Olá, Mundo para aprender o fluxo de trabalho de pull request do GitHub.

Neste artigo

Introdução

Este tutorial ensina GitHub conceitos essenciais, como repositórios, ramificações, commits e pull requests. Você criará seu próprio repositório Olá, Mundo e aprenderá o fluxo de trabalho de pull request do GitHub, uma maneira popular de criar e revisar código.

Neste guia de início rápido, você irá:

  • Criar e usar um repositório.
  • Iniciar e gerenciar um novo ramo.
  • Faça alterações em um arquivo e envie-as para GitHub como commits.
  • Abrir e fazer o merge de um pull request.

Pré-requisitos

  • Você deve ter uma GitHub conta.

  • Você não precisa saber como codificar, usar a linha de comando ou instalar o Git (o software de controle de versão criado GitHub ).

Etapa 1: Criar um repositório

A primeira coisa que faremos é criar um repositório. Você pode pensar em um repositório como uma pasta que contém itens relacionados, como arquivos, imagens, vídeos ou até mesmo outras pastas. Um repositório geralmente agrupa itens que pertencem ao mesmo "projeto" ou coisa em que você está trabalhando.

Geralmente, os repositórios incluem um arquivo README, um arquivo com informações sobre seu projeto. Arquivos README são escritos em Markdown, que é uma linguagem fácil de leitura e escrita para formatar texto simples. Você pode saber mais sobre arquivos Markdown e README em Sintaxe básica de escrita e formatação e Gerenciar o README do seu perfil.

GitHub permite adicionar um arquivo README ao mesmo tempo em que cria seu novo repositório. GitHub também oferece outras opções comuns, como um arquivo de licença, mas você não precisa selecionar nenhuma delas agora.

Seu repositório hello-world pode ser um lugar em que você armazena ideias, recursos ou até compartilha e discute assuntos com outras pessoas.

  1. No canto superior direito de qualquer página, selecione e clique em Novo repositório.

    Captura de tela de um menu suspenso GitHub mostrando as opções para criar novos itens. Há um item de menu "Novo repositório" com o contorno em laranja escuro.

  2. Na caixa "Nome do repositório", digite hello-world.

  3. Na caixa "Descrição", digite uma breve descrição. Por exemplo, digite "Este repositório é para praticar o GitHub Flow".

  4. Selecione se o repositório será Público ou Privado.

  5. Selecione Adicionar um arquivo LEIAME.

  6. Clique em Criar repositório.

Etapa 2: Criar um ramo

O Branch permite que você tenha diferentes versões de um repositório de uma só vez.

Por padrão, seu repositório tem um branch chamado main que é considerado o branch definitivo. Você pode criar branches adicionais com base em main no repositório.

O branch é útil quando você deseja adicionar novas funcionalidades a um projeto sem alterar a fonte principal do código. O trabalho realizado em diferentes branches não aparecerá na branch principal até que você faça o merge, processo que abordaremos mais detalhadamente mais tarde neste guia. Você pode usar ramificações para fazer experimentos e edições antes de fazer seu commit em main.

Quando você cria um branch a partir do branch main, você faz uma cópia ou um instantâneo de main como ele era naquele momento. Se outra pessoa fez alterações no branch main enquanto você estava trabalhando no seu branch, você pode puxar essas atualizações.

Este diagrama mostra:

  • O ramo main
  • Um novo branch chamado feature
  • A jornada que feature percorre através das etapas "Confirmar alterações", "Enviar solicitação de pull" e "Discutir alterações propostas" antes de ser integrada ao main.

Diagrama das duas ramificações. O ramo "recurso" diverge da ramificação "principal" e em seguida é mesclado novamente ao "principal".

Criando um ramo

  1. Clique na guia Código do repositório hello-world.

  2. Acima da lista de arquivos, clique no menu suspenso que diz main.

    Captura de tela da página do repositório. Um menu suspenso, rotulado com um ícone de ramificação e "main", está realçado com um contorno laranja.

  3. Digite um nome de branch, readme-edits, na caixa de texto.

  4. Clique em Criar branch: readme-edits a partir do main.

    Captura de tela do menu suspenso do branch de um repositório. "Criar branch: readme-edits de 'main'" está contornado em laranja escuro.

Agora você tem dois ramos, main e readme-edits. Neste momento, eles são exatamente os mesmos. Em seguida, você adicionará alterações ao novo branch readme-edits.

Etapa 3: Faça alterações e faça o commit

Quando você criou um novo branch na etapa anterior, GitHub trouxe você para a página de código do novo readme-edits branch, que é uma cópia de main.

Você pode fazer e salvar as alterações nos arquivos do seu repositório. No GitHub, as alterações salvas são chamadas de commits. Cada commit tem uma mensagem de commit associada, que é uma descrição que explica por que uma determinada alteração foi feita. As mensagens de commit capturam histórico das suas alterações para que outros colaboradores possam entender o que você fez e o porquê.

  1. Abaixo do branch readme-edits que você criou, clique no arquivo README.md.
  2. Para editar o arquivo, clique em .
  3. No editor, escreva um pouco sobre você.
  4. Clique em Confirmar alterações.
  5. Na caixa "Fazer commit das alterações", escreva uma mensagem de commit que descreva as alterações.
  6. Clique em Confirmar alterações.

Essas alterações serão feitas somente no arquivo README no branch readme-edits, ou seja, agora esse branch tem um conteúdo diferente de main.

Etapa 4: Abrir uma solicitação de pull

Agora que você tem alterações em um branch com base em main, abra uma solicitação de pull.

Pull requests são o coração da colaboração no GitHub. Ao abrir um pull request, você está propondo suas alterações e solicitando que alguém analise e incorpore sua contribuição, mesclando-a no branch deles. Os pull requests mostram diffs, ou diferenças, do conteúdo de ambos os branches. As alterações, adições e subtrações são exibidas em cores diferentes.

Assim que você fizer um commit, você poderá abrir um pull request e começar uma discussão, mesmo antes de o código ser concluído.

Nesta etapa, você abrirá uma solicitação de pull em seu próprio repositório e, em seguida, irá mesclá-la você mesmo. É uma ótima maneira de praticar esse GitHub fluxo antes de trabalhar em projetos maiores.

  1. Clique na guia Solicitações de pull do repositório hello-world.

  2. Clique em New pull request.

  3. Na caixa Exemplos de Comparações, selecione o branch que você criou, readme-edits, para compará-lo com main (o original).

  4. Veja as mudanças que você fez na página de Comparação e certifique-se que eles são o que você deseja enviar.

    Captura de tela de uma comparação para o arquivo LEIAME.md. Três linhas vermelhas listam o texto que está sendo removido e três linhas verdes listam o texto que está sendo adicionado.

  5. Clique em Criar solicitação de pull.

  6. Dê um título ao seu pull request e escreva uma breve descrição das suas alterações. Você pode incluir emojis e arrastar e soltar imagens e gifs.

  7. Clique em Criar solicitação de pull.

Como revisar uma solicitação de pull

Quando você começa a colaborar com outras pessoas, este é o momento em que você pede a revisão delas. Isso permite que seus colaboradores comentem ou proponham alterações em sua solicitação de pull antes de mesclar as alterações no branch main.

Não abordaremos a revisão de solicitações de pull neste tutorial, mas se você estiver interessado em saber mais, consulte Revisões de pull request. Como alternativa, experimente o GitHub Skills curso "Revisão de pull requests".

Etapa 5: Mesclar sua solicitação de pull

Nesta etapa final, você mesclará o branch readme-edits no branch main. Depois que você mesclar a solicitação de pull, as alterações no branch readme-edits serão incorporadas em main.

Às vezes, uma solicitação de pull pode introduzir alterações no código que entram em conflito com o código existente em main. Se houver conflitos, GitHub alertará você sobre o código conflitante e impedirá a mesclagem até que os conflitos sejam resolvidos. Você pode criar um commit que resolve os conflitos ou usar comentários na pull request para discutir os conflitos com os integrantes da equipe.

Neste guia, você não deverá ter conflitos. Portanto, você está pronto para realizar a fusão do seu ramo no ramo principal.

  1. Na parte inferior da solicitação de pull, clique em Mesclar solicitação de pull para mesclar as alterações em main.
  2. Clique em Confirmar mesclagem. Você receberá uma mensagem de que a solicitação foi mesclada com sucesso e o pedido foi encerrado.
  3. Clique em Excluir ramo. Agora que a sua solicitação de pull foi mesclada e as alterações estão em main, você pode excluir o branch readme-edits com segurança. Se você quiser fazer mais alterações no seu projeto, você pode sempre criar um novo branch e repetir este processo.
  4. Clique novamente na guia Código do repositório hello-world para ver as alterações publicadas em main.

Conclusion

Ao concluir este tutorial, você aprendeu a criar um projeto e fazer uma pull request no GitHub.

Como parte disso, aprendemos a:

  • Criar um repositório.
  • Iniciar e gerenciar um novo ramo.
  • Altere um arquivo e faça commit dessas alterações em GitHub.
  • Abrir e fazer o merge de um pull request.

Próximas Etapas 

  • Dê uma olhada no seu GitHub perfil e você verá seu trabalho refletido no grafo de contribuição.
  • Se você quiser praticar as habilidades que aprendeu neste tutorial novamente, experimente o GitHub Skills curso "Introdução a GitHub".
  • Personalize seu perfil e aprenda a sintaxe básica de Markdown para escrever no GitHub, consulte Personalizar seu perfil.

Leitura adicional