Hello World

Introdução

Este tutorial ensina noções básicas sobre o GitHub, como repositórios, branches, commits e pull requests. Você criará seu próprio repositório Hello World e aprenderá o fluxo de trabalho de solicitação de pull 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 por push para o GitHub como commits.
• Abrir e realizar merge de uma solicitação de pull.

Pré-requisitos

• Você precisa ter uma conta do GitHub. Para mais informações, consulte AUTOTITLE.

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

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. Aprenderemos mais sobre Markdown no próximo tutorial, AUTOTITLE.

O GitHub permite que você adicione um arquivo LEIAME enquanto cria o repositório. O 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 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.

   

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

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

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 ramo chamado que é considerado ramo definitivo. Você pode criar branches adicionais com base 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 feito em diferentes branches não aparecerá no branch principal até que você faça o merge, que abordaremos mais tarde neste guia. Você pode usar branches para fazer experimentos e edições antes de fazer commit delas em .

Quando você cria um branch com base no branch, você faz uma cópia ou um instantâneo de como ele era naquele momento. Se outra pessoa fez alterações no branch enquanto você estava trabalhando no seu branch, você pode efetuar pull dessas atualizações.

Este diagrama mostra:

• O branch
• Uma nova ramificação denominada
• A jornada que passa pelos estágios de "Confirmar alterações", "Submeter solicitação pull" e "Discutir alterações propostas" antes de ser mesclada com

Criar um branch

1. Clique na guia Código do repositório .

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

   

3. Digite um nome de branch, , na caixa de texto.

4. Clique em Criar branch: readme-edits com base no principal.

   

Agora você tem dois branches, e . Neste momento, eles são exatamente os mesmos. Em seguida, você adicionará alterações ao novo ramo.

Etapa 3: Fazer alterações e commit

Quando você criou um novo branch na etapa anterior, o GitHub levou você à página de código do novo branch, que é uma cópia de outro branch.

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. Dentro do branch que você criou, clique no arquivo.
2. Clique em para editar o arquivo.
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 , ou seja, agora esse branch tem um conteúdo diferente de .

Etapa 4: Abrir uma solicitação de pull

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

As pull requests são a parte central da colaboração no GitHub. Ao abrir um pull request, você está propondo suas alterações e solicitando que alguém analise e faça pull na sua contribuição e os mescle no seu branch. 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 o fluxo do GitHub antes de trabalhar em projetos maiores.

1. Clique na guia de Pull Requests do seu repositório.

2. Clique em Nova pull request.

3. Na caixa Exemplos de Comparações, selecione o branch que você criou para compará-lo com (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.

   

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 no seu pull request antes de você mesclar as mudanças no branch.

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

Etapa 5: Mesclar sua solicitação de pull

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

Às vezes, uma solicitação de pull pode introduzir alterações no código que entram em conflito com o código existente em . Se houver algum conflito, o 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.

Nesta apresentação, você não deverá ter conflitos. Portanto, você está pronto para fazer merge do seu branch no branch principal.

1. Na parte inferior da solicitação de pull, clique em Mesclar solicitação de pull para mesclar as alterações em .
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 , você pode excluir o branch 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 para ver as alterações publicadas em .

Conclusão

Depois de concluir o tutorial, você saberá 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 das alterações no GitHub.
• Abrir e realizar merge de uma solicitação de pull.

Próximas etapas

• Acesse seu perfil do GitHub para conferir seu trabalho no gráfico de contribuição.
• Se você quiser praticar as habilidades aprendidas neste tutorial novamente, experimente o GitHub Skills curso "Introdução ao GitHub".
• No próximo tutorial, AUTOTITLE, você aprenderá a personalizar seu perfil e também aprenderá alguma sintaxe básica do Markdown para escrever no GitHub.

Leitura adicional

• AUTOTITLE