{"componentChunkName":"component---src-templates-blog-post-index-js","path":"/padroes-e-nomenclaturas-no-git/","result":{"data":{"markdownRemark":{"fields":{"slug":"/padroes-e-nomenclaturas-no-git/"},"frontmatter":{"category":"Git","date":"03/06/2020","description":"Como você cria suas branches? E seus commits? Possui padrões? Veja como eu faço...","featuredImage":{"childImageSharp":{"fluid":{"base64":"data:image/jpeg;base64,/9j/2wBDABALDA4MChAODQ4SERATGCgaGBYWGDEjJR0oOjM9PDkzODdASFxOQERXRTc4UG1RV19iZ2hnPk1xeXBkeFxlZ2P/2wBDARESEhgVGC8aGi9jQjhCY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2P/wgARCAANABQDASIAAhEBAxEB/8QAGAAAAgMAAAAAAAAAAAAAAAAAAAIBAwX/xAAWAQEBAQAAAAAAAAAAAAAAAAABAAP/2gAMAwEAAhADEAAAAcNkfQrJC//EABgQAAIDAAAAAAAAAAAAAAAAAAABEDFB/9oACAEBAAEFAlbnD//EABQRAQAAAAAAAAAAAAAAAAAAABD/2gAIAQMBAT8BP//EABQRAQAAAAAAAAAAAAAAAAAAABD/2gAIAQIBAT8BP//EABQQAQAAAAAAAAAAAAAAAAAAACD/2gAIAQEABj8CX//EABoQAAICAwAAAAAAAAAAAAAAAAABECFRYYH/2gAIAQEAAT8hoE0zhiDP/9oADAMBAAIAAwAAABBzL//EABQRAQAAAAAAAAAAAAAAAAAAABD/2gAIAQMBAT8QP//EABQRAQAAAAAAAAAAAAAAAAAAABD/2gAIAQIBAT8QP//EABoQAQADAQEBAAAAAAAAAAAAAAEAESFBMYH/2gAIAQEAAT8QWlYwO3RG+JxfJqW6WWH1Z//Z","aspectRatio":1.5384615384615385,"src":"/static/781bc8f5e3a6f59b32e79d0bc5090926/86e90/git-log.jpg","srcSet":"/static/781bc8f5e3a6f59b32e79d0bc5090926/17b1e/git-log.jpg 240w,\n/static/781bc8f5e3a6f59b32e79d0bc5090926/2d331/git-log.jpg 480w,\n/static/781bc8f5e3a6f59b32e79d0bc5090926/86e90/git-log.jpg 960w","srcWebp":"/static/781bc8f5e3a6f59b32e79d0bc5090926/c30ee/git-log.webp","srcSetWebp":"/static/781bc8f5e3a6f59b32e79d0bc5090926/e8667/git-log.webp 240w,\n/static/781bc8f5e3a6f59b32e79d0bc5090926/87b7f/git-log.webp 480w,\n/static/781bc8f5e3a6f59b32e79d0bc5090926/c30ee/git-log.webp 960w","sizes":"(max-width: 960px) 100vw, 960px"}}},"photographer":"","title":"Padrões e nomenclaturas no Git"},"timeToRead":5,"html":"

E ae, meus nobres \"codeiros\" adoradores de uma cerveja e/ou café, como estamos? Falarei aqui sobre algumas práticas de padrões e nomenclaturas no Git. Sim, será meu primeiro artigo sobre Git, ferramenta que gosto pra meireles.

\n

Padrão pra quê? Faz de qualquer jeito e que se foda...

\n

Beleza, vai na fé, portanto, espero nunca ter que trabalhar contigo ou contribuir em algum repositório seu. Brincadeiras à parte, vou mostrar aqui algumas coisas que uso na Wooza, empresa onde eu trabalho e nos meus projetos pessoais.

\n

Padrões nos nomes de branches

\n

Em termos de padrões e nomenclaturas no Git, acho esse ponto importante, mas confesso que não tão primordial assim. Mas acredito que é sempre sagaz ter um padrão de nomenclaturas e um nome explicativo nas branches.

\n

Os prefixos

\n

\n \n \n

\n

Sim, eu uso prefixos pré-definidos para criar uma branch. Segue abaixo a lista:

\n\n

Em si já dá pra saber um pouco sobre cada prefixo, mas vamos com uma breve explicação sobre eles...

\n

bugfix/

\n

Como o próprio nome já diz, é um BUG e precisa ser corrigido de forma imediata, o quanto antes. Num outro artigo eu explico melhor a utilização desse cara e branches principais.

\n

feature/

\n

O nome já diz também o que é, uma nova feature que será adicionada ao projeto, componente e afins.

\n

hotfix/

\n

Às vezes esse termo pode ser usado de outras formas, até mesmo para usar no lugar do bugfix. Porém, eu prefiro separar, deixar com semânticas diferentes.

\n

Ele é bem similar ao bugfix/, porém, ele não é um BUG, mas sim uma correção, seja ela de cor, textos, alterações não tão urgentes, que não signifiquem BUG's.

\n

improvement/

\n

O nome já mostra para o que serve. Em si é uma melhoria para um fodasse já existente, seja de performance, de escrita, de layout, etc.

\n

Sagaz, Dulcetti. Só faltou falar dos commits

\n

\n \n \n

\n

Sim, sim. Em termos de padrões e nomenclaturas no Git, acho essa parte essencial. Eu gosto de analisar um PR olhando as mensagens de commit. Se elas forem bem explicativas, já consigo saber o porquê daquele PR.

\n

Bom, claro, em si o PR seria pra isso, com sua descrição, etc. Mas isso pode ficar para mais um artigo futuro ;)

\n

Pros meus commits eu uso o Commitizen. Bom, na verdade eu não uso ele não, mas sigo seus padrões. A grande merda foi que lá na Wooza usamos Windows, e esse cara não funcionou corretamente na minha máquina. Portanto, segui usando os padrões dele na mão mesmo.

\n

Instalação do commitizen

\n

Só instalar globalmente na sua máquina:

\n
yarn add global commitizen
\n

Feito isso, agora pra usar é só lançar o comando seguinte no terminal:

\n
git cz
\n

Feito isso ele abrirá o painel com seus prefixos para você escolher. Vamos a eles...

\n

Prefixos do commitizen

\n

\n : [1, 'always'],\n 'footer-leading-blank': [1, 'always'],\n 'header-max-length': [2, 'always', 72],\n 'scope-case': [2, 'always', 'lower-case'],\n 'subject-case': [2, 'never', ['sentence-case', 'start-case', 'pascal-case', 'upper-case']],\n 'subject-empty': [2, 'never'],\n 'subject-full-stop': [2, 'never', '.'],\n 'type-case': [2, 'always', 'lower-case'],\n 'type-empty': [2, 'never'],\n 'type-enum': [\n 2,\n 'always',\n [\n 'build',\n 'chore',\n 'ci',\n 'docs',\n 'feat',\n 'fix',\n 'perf',\n 'refactor',\n 'revert',\n 'style',\n 'test',\n ],\n ],\n },\n};\n

Percebam que ele possui um array com todos os padrões dele. Se quiser algum prefixo a mais, adicione lá. E caso queira remover algum, fique à vontade.

\n

Percebam também que existem outras configurações antes da lista de prefixos. Algo como deixar o seu scopo de commit sempre em letra minúscula, o tamanho máximo que o header pode ter em caracteres, deixar o tipo vazio, em letra minúscula, dentre outras coisas. Dá pra fazer muita coisa bacanuda nesse fodasse ae.

\n

Veja o repositório do Commitlint.

\n

Finalizando

\n

Bom, tem mais coisas que eu posso escrever em mensagens de commits e afins, mas preferi deixar esse artigo focado só nesses dois caras. Em breve eu crio outro falando mais sobre branches, como preparo mensagens de commit, sem ser relacionado ao prefixo e afins, criação de Pull Requests, dentre outras coisas.

\n

E ae, o que acharam? Faltou algo? Usam esses caras? Usam alguma outra coisa? Só falar ae.

\n

Beijo na alcatra

"}},"pageContext":{"nextPost":{"fields":{"slug":"/como-colocar-um-feed-no-seu-blog-com-o-gatsby/"},"frontmatter":{"title":"Como colocar um feed no seu Blog com o Gatsby"}},"previousPost":{"fields":{"slug":"/a-volta-dos-que-nao-foram/"},"frontmatter":{"title":"A volta dos que não foram..."}},"slug":"/padroes-e-nomenclaturas-no-git/"}},"staticQueryHashes":["1271460761","2963127411","3623170217","764694655"]}