3

Uma dúvida que sempre tive e me dá muita dor de cabeça, é sobre como eu devo fazer o Versionamento Semântico com o GIT.

Eu deveria levar em consideração o commit, um "release" do projeto, ou outra coisa?

Release

Exemplo de um histórico de commit's com o tipo de alteração levando em consideração que o número de versão seja definida num release.

v2.1.4 - Release 04

(O release teve 1 major, 1 minor e 4 patches)

  • Patch
  • Major
  • Patch
  • Patch
  • Minor
  • Patch

v1.3.4 - Release 03

(O release teve 2 minors e 4 patches)

  • Patch
  • Patch
  • Minor
  • Patch
  • Patch
  • Patch
  • Minor

v1.1.5 - Release 02

(O release teve 1 minor e 5 patches)

  • Patch
  • Patch
  • Minor
  • Patch
  • Patch
  • Patch

v1.0.3 - Release 01

(O release teve 3 patches)

  • Patch
  • Patch
  • Patch

Commit

Exemplo de um histórico de commit's com o tipo de alteração levando em consideração que o número de versão seja definida assim que um commit seja feito.

v2.0.1 - Release 04

  • Patch (2.0.1)
  • Major (2.0.0)
  • Patch (1.4.2)
  • Patch (1.4.1)
  • Minor (1.4.0)
  • Patch (1.3.2)

v1.3.1 - Release 03

  • Patch (1.3.1)
  • Minor (1.3.0)
  • Patch (1.2.3)
  • Patch (1.2.2)
  • Patch (1.2.1)
  • Minor (1.2.0)

v1.1.2 - Release 02

  • Patch (1.1.2)
  • Patch (1.1.1)
  • Minor (1.1.0)
  • Patch (1.0.6)
  • Patch (1.0.5)
  • Patch (1.0.4)

v1.0.3 - Release 01

  • Patch (1.0.3)
  • Patch (1.0.2)
  • Patch (1.0.1)

Da pra ver que tiveram versões diferentes:

inserir a descrição da imagem aqui

Com a especificação da pra dizer qual seria a maneira de se fazer? (Mesmo que não seja essas), ou é algo em que a equipe decide e não tem nada que afirme?

9
  • Você precisa saber qual tipo de lançamento (portanto, release) está fazendo para saber em que ponto do M.m.i você vai incrementar. Não faz sentido fechar uma versão sem fechar. E, dependendo do que entrou, você precisa subir um ou outro número Commented 31/03/2018 às 14:37
  • Mas a maneira como estou fazendo no exemplo de release está correta? Commented 31/03/2018 às 15:06
  • 1
    Eu diria que não. Cada versão para mim seria uma release diferente. Não juntaria diversas versões em um lançamento. Só faz sentido você subir a versão quando há lançamento, então dizer que uma release consiste de 6 versões eu vejo como uma ofensa ao versionamento semântico pior do que xingar a mãe. Você pode ter diversos tipos de correção em um lançamento, mas isso só implicaria subir um dos números do M.m.i e zerar os números menos significativos Commented 31/03/2018 às 15:12
  • 1
    isso mesmo. Mais tarde verifico se já tem uma resposta adequada e, não havendo, escrevo uma Commented 31/03/2018 às 15:27
  • 2
    Sim, a própria especificação define: "Uma vez que um pacote versionado foi lançado(released), o conteúdo desta versão NÃO DEVE ser modificado. Qualquer modificação DEVE ser lançado como uma nova versão" ou seja do MAJOR 1.x.x só poderia seguir pra o MAJOR 2.x.x. semver.org/lang/pt-BR/#spec-item-3 Commented 31/03/2018 às 15:28

1 Resposta 1

3

tudo certo?

Estarei fazendo um pequeno resumo com base em alguns artigos e conteúdos sobre "Semantic Version".

0.0.1
Patch:
- Utilizado para informar "hot-fixes" e eles não alteram a funcionalidade do código, porém resolvem "bugs".

Observação: É incrementado sempre por uma unidade e não possuí limites em sua aplicação.
Exemplo: 0.1.30


0.1.0
Minor:
- Utilizado para representar novas funcionalidades(features) no projeto.


Observação: Quando incrementado reseta todas as unidades de "patch" anteriores ou seja resultando em uma nova funcionalidade sem "bugs" até o momento.
Também incrementa por uma unidade.
Exemplo: 0.0.15 --> 0.1.0


1.0.0
Major:
- Representa uma versão incompatível ou alguma alteração drástica no projeto.

Observação: Incrementa-se por uma unidade e quando atualizado, reseta-se versões de "minor" e "patch".
Exemplo: Uma biblioteca utiliza estancias para sua utilização e na sua próxima versão utiliza exportação nomeada para utilizar suas funcionalidades. Sendo assim incompatível a forma anterior de sua utilização. 0.5.10 --> 1.0.0



Bibliografia:
A successful Git branching model
A quick intro to Semantic Versioning: what it is, and why we use it
What is Semantic Versioning?


Espero tê-lo ajudado! 🤘

Você deve fazer log-in para responder a esta pergunta.

Esta não é a resposta que você está procurando? Pesquise outras perguntas com a tag .