Semantic Versioning: 1.0.1, 2.3.1 o que é isso?

Ao desenvolver um projeto, parte do seu trabalho como desenvolvedor(a) será documentar e versionar seu código. Ja reparou aqueles números 2.3.1 ou 1.0.4? eles não são definidos de forma aleatória! São definidos por uma convensão chamada Semantic Versioning.

O que é Semantic Versioning?

Você está desenvolvendo ou já tem um pacote JavaScript super útil que outros desenvolvedores estão usando em seus projetos. Cada nova funcionalidade que você implementa no seu pacote ou cada bug que você corrige precisa ser avisado as pessoas que utilizam esse seu pacote.

Como devo fazer?

Nesse momento o Semantic Versioning te ajuda! Ele quebra o número de versão do seu pacote em três partes: X.Y.Z.

X é a versão principal, ou major. Isso muda quando você faz mudanças que podem quebrar o código das pessoas que estão usando seu pacote.

Y é a versão secundária, ou minor. Isso muda quando você adiciona uma nova funcionalidade, mas não quebra o código das pessoas.

Z é a versão de correção, ou patch. Isso muda quando você corrige um bug, mas não mexe em nada que as pessoas já estejam usando.

Vamos facilitar ainda mais seu entendimento com esses exemplos:

• Você lança a primeira versão do seu pacote? 1.0.0.
• Adicionou uma nova funcionalidade? 1.1.0.
• Corrigiu um bug? 1.1.1.
• Fez mudanças grandes que podem quebrar o código das pessoas? 2.0.0.
• Corrigiu um bug na nova versão? 2.0.1.

Dessa forma todos podem entender de forma clara o impacto das mudancas em seu pacote ou projeto, lembre-se de explicar também no seu README oque há de novo nas suas mudanças.