6.3.1 Editando um Arquivo em um Repositório no GitHub

Agora, vamos fazer a primeira edição no seu novo repositório.

Como, por enquanto, o único arquivo no repositório é o próprio README.md, vamos começar por ele. Nossa primeira modificação será adicionar a frase: Praticando Git + GitHub, para deixar claro o propósito deste repositório.

Edição do Arquivo

Para começar a editar o arquivo README.md, clique no ícone de lápis no canto superior direito da exibição automática do conteúdo.

Isso lhe levará para uma página de edição do arquivo.

Agora, basta adicionar a frase desejada diretamente no arquivo:

Agora, basta adicionar a frase desejada diretamente no arquivo. Este processo é similar ao que fazemos ao editar um arquivo no nosso computador com um editor de texto. A diferença é que a edição está acontecendo no GitHub, não localmente no seu computador.

Adição do Arquivo

Em seguida, clique no botão "Commit Changes".

Depois de fazer a modificação, clique no botão "Commit Changes".

Por trás dos panos, ao clicar nesse botão, o GitHub executa o comando equivalente a git add README.md, que coloca o arquivo na área de staging, preparando-o para o commit.

Commit e Push da Alteração

Na tela seguinte:

• Preencha o campo "Commit message" com: Atualizando o README.md.

• Preencha o campo "Extended Description" com: Adicionando o objetivo do repositório.

• Selecione a opção Commit directly to the main branch.

Por fim, clique novamente em "Commit Changes". Isso irá criar um commit de fato, como se você tivesse rodado o comando git commit -m "Adicionando o objetivo do repositório". Além disso, o GitHub também fará automaticamente o push da alteração para a branch principal, já que selecionamos a opção "Commit directly to the main branch".

Agora, a sua modificação foi registrada na branch principal do repositório.

Verificando a Alteração

Logo você já perceberá que o arquivo foi atualizado.

E ao voltar à página principal do repositório, também verá que a sua alteração já foi aplicada e está visível lá.

Atenção ⚠️

Boas Práticas de Fluxo de Trabalho

Embora esse processo seja uma forma prática de fazer alterações diretamente pelo GitHub, não é recomendado para o dia a dia, especialmente em projetos maiores ou quando for necessário alterar vários arquivos. O ideal é evitar fazer commits diretamente na branch principal (main). Este fluxo foi usado aqui apenas para fins didáticos.

Em situações reais, as alterações devem ser feitas utilizando branches e pull requests, um processo que veremos mais adiante. Isso ajuda a manter o fluxo de trabalho mais organizado e seguro, especialmente quando se trabalha em equipe.