From 8f86be629d8578dc8f32c070a7e85a81515b4ea1 Mon Sep 17 00:00:00 2001 From: Pedro Lucas Porcellis Date: Tue, 18 Nov 2025 00:59:26 -0300 Subject: [PATCH] =?UTF-8?q?Expande=20informa=C3=A7=C3=B5es=20sobre=20commi?= =?UTF-8?q?ts=20com=20algumas=20informa=C3=A7=C3=B5es=20e=20dicas=20ligeir?= =?UTF-8?q?amente=20mais=20t=C3=A9cnicas?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../2.3.2-commit.md | 18 +++++++++++++++--- .../3.2.3-criando-commits-via-git-commit.md | 18 ++++++++++++++++++ 2 files changed, 33 insertions(+), 3 deletions(-) diff --git a/ebook/2.-fundamentos-de-controle-de-versao-e-git/2.3-conceitos-fundamentais-do-git/2.3.2-commit.md b/ebook/2.-fundamentos-de-controle-de-versao-e-git/2.3-conceitos-fundamentais-do-git/2.3.2-commit.md index 6103a7d..7a67194 100644 --- a/ebook/2.-fundamentos-de-controle-de-versao-e-git/2.3-conceitos-fundamentais-do-git/2.3.2-commit.md +++ b/ebook/2.-fundamentos-de-controle-de-versao-e-git/2.3-conceitos-fundamentais-do-git/2.3.2-commit.md @@ -2,8 +2,20 @@ #### :flag\_br: Comprometer, registrar -Um commit é uma "foto" do estado atual do repositório. Ele registra quais mudanças foram feitas, por quem e quando. Sendo uma parte fundamental do fluxo de trabalho do Git, permite o registro, acompanhamento e reversão de alterações no código-fonte de um projeto. Os commits são a base para o versionamento de código e colaboração eficaz entre desenvolvedores. - - +Um commit é uma "foto" do estado atual do repositório. Ele registra quais +mudanças foram feitas, por quem e quando. Sendo uma parte fundamental do fluxo +de trabalho do Git, permite o registro, acompanhamento e reversão de alterações +no código-fonte de um projeto. Os commits são a base para o versionamento de +código e colaboração eficaz entre desenvolvedores.

Nesta imagem temos 2 commits diferentes, e cada um possui seu próprio ID, informações de autoria, data/hora e uma breve descrição. Eles se comportam como um "print screen" que capta todas essas informações no momento em que o Desenvolvedor "commita" essas atualizações.

+ +O commit permite que você trabalhe em cascatas de mudanças, onde cada commit +representa um conjunto lógico de alterações. Isso facilita a revisão do código, +a identificação de bugs e a colaboração com outros desenvolvedores, pois cada +commit pode ser analisado individualmente. Cada commit possui um identificador +único, geralmente um hash SHA-1 (ou seja, o git vai calcular um identificador +que represente exatamente aquela mudança naqueles arquivos), que permite +rastrear e referenciar especificamente cada conjunto de mudanças. Além disso, os +commits podem e devem incluir mensagens descritivas que ajudam a entender o +propósito das alterações feitas. diff --git a/ebook/3.-operacoes-locais-basicas-no-git/3.2-salvando-alteracoes-localmente/3.2.3-criando-commits-via-git-commit.md b/ebook/3.-operacoes-locais-basicas-no-git/3.2-salvando-alteracoes-localmente/3.2.3-criando-commits-via-git-commit.md index 82e2b1a..b62fdd3 100644 --- a/ebook/3.-operacoes-locais-basicas-no-git/3.2-salvando-alteracoes-localmente/3.2.3-criando-commits-via-git-commit.md +++ b/ebook/3.-operacoes-locais-basicas-no-git/3.2-salvando-alteracoes-localmente/3.2.3-criando-commits-via-git-commit.md @@ -29,6 +29,24 @@ Uma das características mais importantes do Git é que ele salva "snapshots" (f 2. **Histórico Claro:** Ter snapshots completos facilita entender o estado do projeto em qualquer ponto no tempo. 3. **Restauração Simples:** Se precisar voltar a um estado anterior, você tem uma imagem completa do projeto, sem precisar recompor todas as mudanças uma por uma. +**E que mensagem colocar?** + +Bom, ao fazer um commit, é importante incluir uma mensagem que descreva +claramente as mudanças feitas. Isso ajuda você e outros desenvolvedores a +entender o propósito do commit no futuro. É convencional escrever mensagens de +commits curtas e descritivas, geralmente no tempo presente, quase como se ela +respondesse à pergunta: "O que este commit faz?". A origem é incerta, mas é +possivel compreender ela como uma prática que surge do envio de alterações por +e-mail, que é o formato padrão que o Git foi desenhado para trabalhar. Portanto, +como os commits são enviados por e-mail, as mensagens de commit são escritas +como comandos no tempo presente, o que facilita a revisão já que elas não são +guardadas em um log único de alterações, mas sim em diversos e-mails. + +Dado esse contexto histórico, geralmente a lógica é reservar na primeira linha +do commit, em torno de 50 caracteres, uma descrição sucinta do que foi alterado. +E depois, se necessário, adicionar mais detalhes nas linhas seguintes, separadas +por uma linha em branco. + ## **Estrutura** O formato base do comando git commit é: