Por que todo mundo não está cometendo da mesma maneira?
Infelizmente, os commits não têm uma maneira universal de serem escritos. Cada projeto e cada empresa definem regras específicas para suas necessidades.
Não se preocupe; você encontrará frequentemente maneiras semelhantes de escrever a mensagem.
No entanto, eu recomendo que você leia as regras antes de iniciar uma empresa ou trabalhar em um projeto de código aberto.
Darei a você mais detalhes sobre essas diretrizes posteriormente neste artigo.
Por que é essencial escrever bem o seu commit
Criei uma lista restrita das vantagens de usar uma boa mensagem de confirmação.
- Uma colaboração melhor: Se você estiver trabalhando em uma empresa, em um projeto de código aberto, é essencial seguir as regras para uma melhor cooperação. Se você escrever algo compreensível, seguindo as regras do projeto, os outros desenvolvedores poderão trabalhar com mais eficiência e não precisarão fazer perguntas sobre seu trabalho.
Nota: Se você estiver trabalhando em um projeto pessoal, é altamente recomendável que você siga regras específicas. Isso aumentará sua produtividade e, se você pedir ajuda a outro desenvolvedor, será mais fácil para ele começar a trabalhar em seu projeto.
- Um melhor entendimento: Você precisa criar mensagens claras e compreensíveis; isso ajudará você e seu colaborador a trabalhar em um projeto. Abaixo, você pode encontrar um exemplo de um histórico de confirmação do git com apenas mensagens pouco claras. Como você pode ver, é difícil entender o que é feito.
- BÔNUS – Uma geração de changelog: Vou lhe contar um pequeno segredo: se você escrever boas mensagens, poderá gerar um log de alterações diretamente de suas mensagens de confirmação. Compartilho com você algumas ferramentas para fazer isso: Github Changelog Generator, Git Chglog, Registro de alterações automáticoe Registro de alterações convencional. Provavelmente, a próxima parte da série será sobre isso, se você quiser ser atualizado, você pode me seguir no Twitter. Eu posto todas as atualizações lá.
Como escrever uma mensagem de confirmação?
Se você quiser escrever uma boa mensagem de confirmação, siga algumas regras. Criei uma lista de verificação abaixo. Toda vez que você deseja confirmar, reserve um tempo para consultar esta lista.
- Sempre verifique sua gramática. Nunca é agradável ler uma mensagem cheia de erros. Para fazer isso, eu recomendo que você use uma ferramenta de gramática. Se você está escrevendo em inglês, pode usar Grammarly, Reversoou Verificação de gramática. Essas ferramentas não são perfeitas, mas removerão a maioria dos seus erros.
- Um commit, uma mudança. Tente se comprometer com frequência. O ideal é ter cada alteração em um commit diferente. Será mais fácil voltar ao trabalho anterior.
- Seja claro. Ao escrever um commit, tente ser o mais transparente possível. Eu recomendo que você use o inglês simples para ir direto ao ponto.
- Detalhes o que você fez. Reserve um tempo para reler seu código e escrever o que você fez. No caso de você precisar detalhar muito, recomendo que você use a parte da descrição do commit.
INFORMAÇÃO ADICIONAL: Quero compartilhar com você mais detalhes sobre o comando ‘git commit’. Se você não estiver usando um software git, saiba que é possível criar uma consolidação detalhada digitando este comando:
$ git commit -m "Title" -m "Description"É o mesmo de antes, mas com uma segunda parte para a descrição. Portanto, “-m ‘title'” é escrever o título abreviado do commit e “-m ‘description'” é escrever a descrição se você precisar fornecer mais detalhes.
- Use uma diretriz git. Se você deseja ter um histórico claro de confirmação do git, recomendo que você siga uma diretriz. É um guia de como se comprometer. No meu caso, eu escolho este simples da Udacity. Existem muitos outros; alguns deles são Compromissos convencionaise Diretriz Angular. Uma diretriz de consolidação ajudará você a colocar uma arquitetura em sua consolidação. Por exemplo, coloque uma tag para esclarecer o que você fez: “git commit -m fix: exclua corretamente todas as informações do usuário quando o botão excluir conta for acionado ‘”.
Conclusão
Espero que você tenha gostado deste guia sobre como se comprometer com o Git! Se você tiver alguma dúvida ou comentário, não hesite em perguntar.
Se você tiver outras dicas sobre como fazer boas confirmações, entre em contato.
Não perca meu conteúdo, seguindo-me no Twitter e Instagram.
Você pode encontrar outros artigos como este no meu site: herewecode.io.
Quer mais?
- A cada semana, faça uma cotação motivacional com alguns conselhos, um breve tutorial em alguns slides e a foto de um desenvolvedor sobre Instagram.
- Assine a newsletter e obtenha os artigos, cursos, tutoriais, dicas, livros, motivação e outros conteúdos exclusivos mais recentes.