---
# System prepended metadata

title: Development Guidelines - Branching and Merging
tags: [Development-Guidelines]

---

---
title: Development Guidelines - Branching and Merging
tags: Development-Guidelines
---

## Branching and Merging

As tarefas do board no *ClickUp* que dependem de implementação de código devem seguir uma organização de *branching & merging*. A nomenclatura deve considerar o **Task ID** da tarefa.

![](https://i.imgur.com/RIV8Lew.png)


#### Nomes dos branches devem:

* Seguir **kebab-case**;
* Ser em **inglês**.

#### Épicos ou user stories com subtarefas

No caso de "user stories" ou épicos, usar branches de *epic* para agrupar as *features* (`feature`) que serão descritas em subtarefas.

* `epic/{{Task ID}}-please-dont-make-me-think`
    * `feature/{{Task ID}}-naming-branches-isnt-my-best-skill`

:warning: Um ***feature branch*** aberto de uma *epic branch* deve retornar ao *epic branch* por um MR que deve ser revisado por pares. Um ***epic branch*** aberto da *master* deve retornar à ***master***.

#### Histórias técnicas

Features menores não atreladas a nenhum épico ou release podem ir diretamente pra ***master*** mediante MR revisado por pares.

* `feature/{{Task ID}}-naming-branches-isnt-my-best-skill`

#### Bugfix

Correções de bugs não relacionadas a nenhuma *user story* em andamento podem ir diretamente pra ***master*** mediante MR revisado por pares.

* `fix/{{Task ID}}-really-important-bug-to-solve`

### Merge Requests

**Merge requests** devem ser escritos em português: título e corpo. Caso haja relação com uma tarefa do ClickUp, o título deve conter o *Task ID*. Ex: `[CU-351fkh] Altera endpoint da API...`.

Eles devem seguir este [template de MR](https://hackmd.io/@multicast/mr-template).