search
githubEditar

10.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.

hashtag
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.

Interface do GitHub mostrando o repositório 'hello-world'. Há uma parte destacada em roxo indicando o ícone de lápis para edição do arquivo README.md
Botão de edição do README

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

Interface do GitHub mostrando o editor do arquivo README.md do repositório 'hello-world'. O usuário está editando a descrição inicial do projeto, que é o primeiro repositório criado na plataforma
Tela de edição do arquivo README

Agora, basta adicionar a frase desejada diretamente no arquivo:

Interface do GitHub mostrando o editor do arquivo README.md do repositório 'hello-world'. O usuário está editando a descrição inicial do projeto, agora tem-se adicionada a frase `Praticando Git + GitHub`, após o texto `Meu primeiro repositório no GitHub.`
Tela de edição do arquivo README com a nova alteração

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.

hashtag
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.

hashtag
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.

Janela de commit do GitHub: A imagem mostra uma janela modal típica do GitHub usada para confirmar alterações antes de enviá-las para o repositório. Mensagem de commit: Há um campo para inserir a mensagem de commit, que descreve brevemente as alterações realizadas. Descrição estendida: Um campo adicional permite adicionar uma descrição mais detalhada das mudanças. Opções de commit: O usuário pode escolher entre commitar diretamente na branch principal (main) ou criar uma nova branch e iniciar um pull request.
Janela de confirmação de commit

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.

hashtag
Verificando a Alteração

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

Tela de detalhes do arquivo README. Mostra conteúdo do arquivo README.md do repositório 'hello-world'. O usuário está visualizando a descrição inicial do projeto, que é o primeiro repositório criado na plataforma. O texto indica que o usuário está praticando as ferramentas Git e GitHub.
Página do arquivo README

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á.

Página principal do repositório hello-world mostrando o README atualizado.
Página principal do repositório - aba code.

hashtag
Atenção ⚠️

hashtag
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.

Anterior10.3 Página Principal de um Repositório: Aba CodePróximo10.3.2 Explorando o Histórico de Commits de um Repositório no GitHub

Atualizado

Isto foi útil?