Editar

11.2.3 Realizando Alterações Localmente

Dando continuidade ao processo de contribuição com forks e pull requests, é hora de realizar as alterações necessárias localmente. Para isso, vamos seguir as instruções contidas no arquivo README.md do fork.

PRimeiro Fork 🍴

Este repositório foi criado para que você possa praticar o processo de fazer o seu primeiro fork e criar um pull request (PR) a partir dele. Ele é baseado no projeto Spoon-Knife, mas com conteúdo em português (pt-br).

Como Contribuir

Esse exercício é ideal para quem está começando a aprender Git e GitHub, e quer entender como funciona o processo de fazer um fork e contribuir com um PR em projetos de código aberto.

  1. Faça um fork deste repositório.

  2. Adicione uma ou mais linhas ao arquivo GARFO.md.

  3. Crie um Pull Request com a alteração.

O passo 1 já foi realizado. Agora, vamos focar no próximo passo: adicionar uma linha ao arquivo GARFO.md. Para isso, seguiremos um processo muito parecido com o que abordamos nas seções 9.3.3.2 Editando README.md e 9.3.3.3 Salvando Alterações no Controle de Versão Local:

  1. Editar o Arquivo GARFO.md

  2. Salvar Alterações no Controle de Versão Local

Editar o Arquivo GARFO.md

1. Abrindo o Visual Studio Code

O primeiro passo é abrir a aplicação Visual Studio Code (visto em9.3.3.1 Editor de Código).

Ao abrir o VSCode, será exibida a aba Bem-vindo. Essa aba apresenta atalhos para abrir projetos, acessar documentação e personalizar o editor.

No entanto, não iremos utilizá-la agora, então pode fechá-la clicando no X no canto da aba.

O editor ficará assim:

2. Abrindo a pasta do repositório

Agora, abra a pasta do repositório no editor. Para isso, clique em Arquivo na barra de menu no topo da tela.

Selecione Abrir Pasta....

Encontre a pasta do repositório PRimeiro-fork, selecione-a e clique em Abrir.

3. Abrindo o arquivo GARFO.md

Na barra lateral esquerda, clique no arquivo GARFO.md para abri-lo.

O conteúdo do arquivo será mostrado no painel central da tela, onde você poderá editá-lo.

Antes de começarmos a edição, vamos visualizar como o arquivo fica formatado. Para isso:

  1. Clique no ícone de Pré-Visualização no canto superior direito.

  2. O VSCode abrirá uma visualização formatada do Markdown ao lado direito, mostrando como o arquivo será exibido no GitHub.

Agora, temos três principais áreas visíveis no editor:

  • Barra lateral esquerda: Lista os arquivos do repositório.

  • Painel central: Área onde editamos o GARFO.md.

  • Painel da direita: Pré-visualização do Markdown formatado.

4. Editando o arquivo

Agora, escreva uma frase logo abaixo da última linha com texto. Fique à vontade para escrever o que quiser, sobre qualquer tema. E não se esqueça de deixar uma linha em branco no final do arquivo.

Neste caso, vamos adicionar a frase Nem vem de garfo que hoje é dia de sopa. .

O arquivo ficará assim:

5. Salvando o arquivo

Por fim, não se esqueça de salvar as alterações no arquivo GARFO.md. Para isso, clique em Arquivo no menu superior.

E, selecione a opção Salvar.

Salvar Alterações no Controle de Versão Local

Agora, vamos registrar as alterações no repositório Git local utilizando um novo branch.

1. Verificar estado atual do repositório

Antes de prosseguir, verifique o status do repositório com git status.

O estado atual do GARFO.md é tracked e modified, uma vez que o arquivo foi modificado anteriormente com a adição da nova linha.

2. Criar um novo branch

Como o projeto é apenas para fins didáticos, e não existe nenhuma documentação sugerindo como deve ser o padrão para nomes de branches, podes escolher como preferirmos.

Então, crie um novo branch com o nome de sua conta de usuário ou o quê preferir. Aqui, iremos utilizar aprendizCumbucaDev e alterne para ele.

3. Verificar estado atual do repositório

Ao verificar o estado do repositório, agora a primeira linha retornada deve ser On branch aprendizCumbucaDev ao a invés de On branch main.

O estado atual do GARFO.md permanece tracked e modified.

4. Adicionar GARFO.md

Agora, adicione o arquivo ao staging area, preparando-o para o commit.

5. Verificar estado atual do repositório

Verifique novamente o estado do repositório.

O estado do GARFO.md agora é tracked e staged.

6. Git commit

Agora, salve as alterações no histórico do Git com um commit.

7. Verificando o log do repositório

Para confirmar que o commit foi registrado corretamente, utilize o comando:

Saída esperada (algo como):

Note que o seu último commit aparece apenas no branch aprendizCumbucaDev, indicado por (HEAD -> aprendizCumbucaDev). Isso significa que seu novo commit está apenas no branch aprendizCumbucaDev, enquanto o branch main local ainda está alinhado com o repositório remoto.

A seguir, vamos enviar as modificações salvas localmente para o seu fork remoto.

Anterior11.2.2 Clonando um ForkPróximo11.2.4 Enviando Alterações Locais para o Fork Remoto

Atualizado

Isto foi útil?