11.2.3 Realizando Alterações Localmente
Atualizado
Isto foi útil?
Atualizado
Isto foi útil?
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 ContribuirEsse 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.
Faça um fork deste repositório.
Adicione uma ou mais linhas ao arquivo GARFO.md.
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:
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:
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.
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:
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.
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:
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.
Agora, vamos registrar as alterações no repositório Git local utilizando um novo branch.
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.
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.
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.
Agora, adicione o arquivo ao staging area, preparando-o para o commit.
Verifique novamente o estado do repositório.
O estado do GARFO.md agora é tracked e staged.
Agora, salve as alterações no histórico do Git com um commit.
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.
Clique no ícone de Pré-Visualização no canto superior direito.
