Git Workflow

O Gitflow é um modelo alternativo de ramificação do Git que consiste no uso de ramificações de recursos (features) e várias ramificações primárias (Master e develop).

Branches

Cada branch relacionada à features será criada a partir da branch dev. Nos tópicos abaixo será explicado as nomenclatura que serão utilizadas para o desenvolvimento.

Requisitos

Antes de criar uma branch nova certifique-se de que:

• Está na branch principal dev.

Criando branchs

Primeiro atualize sua branch local, com o seguinte comando

git pull

Para criar uma nova branch, execute o comando:

git checkout -b <nomeDaBranch>

Como padrão para nomes de branches, foi decidido o seguinte:

<código da tarefa>-<nome da tarefa utilizando camelCase quando necessário>

Por exemplo:

git checkout -b US01-tipoUsuario

Assim que a branch for criada execute o seguinte comando:

git push --set-upstream origin <nome da branch>

Dessa forma a branch será enviada para o repositório remoto no GitLab

Commits

Antes de fazer o commit é necessário preparar as alterações. Temos 2 maneiras de fazer isso:

O comando git add . prepara todas as alterações que foram feitas localmente sejam adicionadas ao commit:

git add .

O comando git add <nomeDoArquivo> prepara apenas as alterações do arquivo informado sejam adicionadas ao commit.

git add <nomeDoArquivo>

Após adicionar as alterações é necessário commitar elas usando o comando

git commit -m "comentario-do-commit"

Faça commit sempre que alguma funcionalidade for alterada, assim garantindo um método fácil de recuperação do código (caso necessário).

Após o commit, compartilhe as alterações no repositório remoto utilizando o comnado git push

git push 

Merge Requests

Assim que uma tarefa for finalizada execute o seguinte comando:

git pull origin dev

O mesmo irá garantir que sua branch está atualizada com a branch dev (caso haja conflitos, resolva-os) e realize um commit com o seguinte nome:

Merge branch 'dev' into '<nome da branch>'

Depois de estar com a sua branch remota pronta para merge, crie um Merge Request no GitLab e preencha com as seguintes informações:

• Source Branch: Sua branch.
• Target Branch: branch dev.
• Título: <código da tarefa>-<nome da tarefa utilizando camelCase quando necessário>
• Descrição: Descrição da tarefa e/ou das mudanças no código

Assim que for criado o Merge Request, passe o card da sua tarefa no trello para "Review" e avise um AGES 3, AGES 4 ou líder da Squad.