Versionamento Semântico

 

Talvez este seja um assunto básico, mas nem por isso deixa de ser importante. O versionamento semântico é aquela sequência de números que determinam a versão de um programa. Esses números possuem um significado e você, desenvolvedor, deve respeitar essa semântica quando lançar uma nova versão de seu sistema ou de sua biblioteca.

Uma versão padrão de programa deve conter três partes: major version, minor version e patch version. M.n.p, sendo que as três partes que compõem a versão devem conter números não negativos (o zero é permitido). E essas três partes devem ser incrementadas seguindo regras já bem estabelecidas no mundo do software:

• Incremente apenas a patch version se você realizou correções de bugs;
• Incremente a minor version se você criou novas funcionalidades ou fez melhorias no seu código;
• Por fim, incremente a major version se você criou alguma funcionalidade nova ou mexeu em alguma parte de seu programa / sistema que o tornou incompatível com a versão anterior.

Essas três regrinhas simples, se seguidas, tornarão a versão do seu programa semanticamente compreensível para quem for consumi-lo. Aumenta a segurança de quem for utilizar seu produto.

No nosso órgão, temos usado o versionamento semântico com sucesso, adicionando também um arquivo texto (CHANGES.TXT) apontando as principais alterações de cada nova versão. Pequenos padrões que auxiliam bastante novos desenvolvedores que entram no projeto (já conseguem, em um arquivo, um histórico de alterações) e também auxilia quem trabalha no projeto permitindo ver rapidamente o que foi alterado, sem necessidade de consultar o log do versionador.

Algumas regras complementares são recomendadas:

• Incremente cada versão em uma unidade;
• Ao incrementar uma parte, zere as partes inferiores (ao incrementar a minor version, zere a patch version; ao incrementar a major version, zere as outras duas versões).

 Outras recomendações que dou para facilitar a vida de toda a equipe:

• Dê publicidade às novas versões de suas bibliotecas. Alguém pode vislumbrar algum problema que você não anteviu com a sua atualização;
• Descreva essas regras em um espaço comum e de fácil acesso à equipe. Pessoalmente, eu recomendo uma Wiki.

Pronto, garanto que agora você vai olhar para as versões dos programas que usa de uma forma diferente!

Um abraço e até o próximo post! Feliz Natal e Um Ano Novo com muita tecnologia nova pra gente!!