Tags anotadas no Git documentam versões importantes
Aprenda a marcar releases com nome, autor, data e mensagem, além de publicar essas referências no repositório remoto.
Uma referência estável
Enquanto branches avançam com novos commits, uma tag normalmente permanece apontando para um ponto específico. Ela pode representar uma versão publicada, uma entrega ou outro marco relevante.
Nomes consistentes tornam automações e comunicação mais previsíveis.
Leve e anotada
Uma tag leve é apenas uma referência. Uma tag anotada cria um objeto com autor, data, mensagem e possibilidade de assinatura, oferecendo contexto adequado para releases.
Para versões oficiais, a tag anotada costuma ser a escolha mais informativa.
Versionamento e publicação
Adote uma convenção compatível com o produto, como versões semânticas quando fizer sentido. A tag criada localmente precisa ser enviada explicitamente ao remoto para ficar disponível à equipe e ao pipeline.
Evite mover silenciosamente uma tag que já foi publicada.
Tag não substitui release notes
A mensagem registra o marco, mas usuários ainda precisam entender mudanças, riscos e instruções de atualização. Relacione a tag a notas de versão e artefatos reproduzíveis.
Uma boa marcação conecta código, documentação e processo de entrega no mesmo ponto verificável.
Quer aplicar isso à sua empresa?
Explique o cenário e eu ajudo a transformar a necessidade em um projeto viável.
Conversar com Tadeu