# Versionamento

### **Mensagens de Versionamento**

Ao realizar qualquer alteração que seja necessário realizar um commit, é importantíssimo adicionar uma mensagem que possa informar do que se trata aquela alteração. Essa mensagem deve ser breve e descritiva, explicando em poucas palavras o que foi alterado, de forma que, caso outro desenvolvedor necessite realizar uma busca pelo log de alterações, as mensagens possam servir de "filtro" para identificar o que é relevante para a sua consulta.

<p class="callout warning">Deve-se evitar ao máximo realizar commits sem mensagem, principalmente em versões e no trunk.</p>

#### **Exemplos**

---

##### **Modelo de Mensagem**

<table border="1" id="bkmrk-caso-xxxxx%3A-descri%E3%A7%E3%A3" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 100%;">Caso XXXXX: Descrição do caso de acordo com o Mantis/Trello.

\- Mensagem descritiva e em poucas palavras do que foi alterado  
  
(Opcional) Desenvolvedor

</td></tr></tbody></table>

---

##### **Criação de branch**

<p class="callout info">Ao criar um branch, deve-se informar o número do caso e a sua descrição de acordo com o Mantis/Trello.</p>

<table border="1" id="bkmrk-caso-xxxxx%3A-descri%E3%A7%E3%A3-0" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 100%;">Caso XXXXX: Descrição do caso de acordo com o Mantis/Trello.

\- Criação do branch  
  
(Opcional) Desenvolvedor

</td></tr></tbody></table>

##### **Alterações** 

<p class="callout info">Ao realizar o commit de alterações, além do cabeçalho indicando o número do caso e a descrição, deve-se adicionar por tópico as alterações feitas naquele commit.</p>

<table border="1" id="bkmrk-caso-xxxxx%3A-descri%E3%A7%E3%A3-1" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 100%;">Caso XXXXX: Descrição do caso de acordo com o Mantis/Trello.

\- Alterações na lógica da rotina CalcularSaldo.

\- Correções no padrão de código aplicado.  
\- Criação da classe TGerador  
  
(Opcional) Desenvolvedor

</td></tr></tbody></table>

##### **Atualização de Branch**

<p class="callout info">Ao realizar a atualização de um branch(Merge com Trunk) , deve-se adicionar a "tag" \[Atualização do Branch\] no início do cabeçalho, para que ao consultar o log de alterações, o desenvolvedor identifique prontamente quais revisões são referentes à atualizações do branch e quais não são.</p>

<table border="1" id="bkmrk-%5Batualiza%E3%A7%E3%A3o-do-bran" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 100%;">\[Atualização do Branch\] Caso XXXXX: Descrição do caso de acordo com o Mantis/Trello.

  
(Opcional) Desenvolvedor

</td></tr></tbody></table>