Guia de bolso para Commits Semânticos
Quem nunca se deparou (ou até mesmo escreveu 🥸) uma mensagem de commit "updates". Na hora de escrever parece inofensivo, mas quando alguém precisa revisar algo no código isso pode se tornar um problemão 🤯
Objetivo da mensagem de commit
Resumindo: descrever de forma rápida o objetivo daquela alteração no código, para facilitar a vida de quem for revisar o código (Inclusive para você mesmo)
Não superestime a sua memória, quem nunca deixou uma task pela metade na sexta e quando voltou na segunda não fazia ideia do que estava fazendo. Lembre-se que no futuro você não vai ter todo o contexto que você tem no momento que está codando
Vamos lá
- "feat: [...]": Usado para criação de
novas features, endpoints, services e etcfeat: create user service
- "fix: [...]": Solução de erros, bugs e afins
fix: error on create user without profile picture
- "refactor: [...]": Quando for refatorar um trecho de código
refactor: refactor create user service
- "chore: [...]": Alterações que não o funcionamento do sistema nem em testes automatizados, como alterações no .gitignore, eslint, README.md e etc
chore: use prettier on eslint rules
- "style: [...]": Alterações de estilo que não influenciam no sistema
style: change background color
- "build: [...]": Alterações que impactam apenas o build do projeto
build: create deploy config file
- "test: [...]": Criação ou modificação de testes automatizados
test: testing create user service
Algumas dicas
- Os padrões podem variar entre empresas, mas geralmente seguem um padrão muito parecido com isso
- Crie o hábito de escrever as mensagens em inglês, é a linguagem universal na programação e você nunca sabe quando vai estar em um projeto com desenvolvedores de fora 😉
- Alguns projetos usam ferramentas como husky para fazer o lint das mensagens de commit, vale a pena dar uma olhada
- Se você usa VSCode eu recomendo a extensão gitlens