Skip to content

Instantly share code, notes, and snippets.

@igorferreira
Created June 20, 2025 22:56
Show Gist options
  • Save igorferreira/71baccb084d620f03ba66971e77b4a50 to your computer and use it in GitHub Desktop.
Save igorferreira/71baccb084d620f03ba66971e77b4a50 to your computer and use it in GitHub Desktop.
versionamento

Melhores Práticas de Versionamento Semântico

Abordagem Recomendada: Pre-releases antes da Produção

Concordo totalmente! 👍 Essa é uma excelente prática e você está seguindo o padrão correto de versionamento semântico.

Por que usar pre-releases (alfa/beta) está correto:

1. Uso adequado de pre-releases (alfa/beta)

  • -alfa indica que é uma versão em desenvolvimento/teste
  • Permite testar funcionalidades antes do release oficial
  • Sinaliza que ainda pode haver mudanças significativas

2. Reservar v1.0.0 para produção

  • A versão 1.0.0 deve representar a primeira versão estável em produção
  • É um marco importante que indica maturidade do software
  • Comunica claramente aos usuários que o software está pronto para uso real

3. Padrão de versionamento semântico ideal:

Desenvolvimento/Testes:

v1.0.0-alfa.1, v1.0.0-alfa.2, v1.0.0-beta.1, etc.

Produção:

v1.0.0 (primeira versão estável)
v1.0.1 (correções de bugs)
v1.1.0 (novas funcionalidades)
v2.0.0 (mudanças breaking)

4. Benefícios dessa abordagem:

  • Clareza: Diferencia claramente desenvolvimento de produção
  • Controle: Permite múltiplas iterações antes da versão final
  • Confiança: v1.0.0 passa mais credibilidade quando lançada
  • Rastreabilidade: Histórico claro da evolução do software

Sugestão para quando for para produção:

Quando estiver pronto para produção, você pode:

  1. Release Candidate: Criar v1.0.0-rc.1 (release candidate) para testes finais
  2. Versão Oficial: Depois v1.0.0 como versão oficial de produção

Exemplo Prático do Projeto:

Versões Atuais (Desenvolvimento):

  • v1.0.0-alfa - Primeira versão alfa
  • v1.0.1-alfa - Correções na versão alfa
  • v1.0.2-alfa - Melhorias incrementais
  • v1.0.3-alfa - Funcionalidades adicionais
  • v1.0.4-alfa - Configuração automática do Redmine totalmente funcional

Próximos Passos:

  • v1.0.0-beta.1 - Quando estiver mais estável para testes amplos
  • v1.0.0-rc.1 - Release candidate para validação final
  • v1.0.0 - Primeira versão oficial de produção

Conclusão

Sua estratégia está perfeita e segue as melhores práticas da indústria! 🎯

O uso de pre-releases permite um desenvolvimento mais controlado e garante que a versão 1.0.0 seja realmente um marco de qualidade e estabilidade.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment