GitLab

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 (main e develop).

• Lembrando que foi disponibilizado no servidor do Discord um documento com um tutorial mais detalhado sobre o funcionamento do git.

Branches

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

Nomes

Os nomes das branchs devem conter o prefixo "feature/" em caso de tarefas de melhorias/adições, ou o prefixo "bugfix/" em caso de tarefas de correção de bugs. Acompanhado do título da tarefa (de preferência o título que está no ClickUp, mas pode ser resumido) em kebab-case; como-neste-exemplo

Requisitos

Para garantir que o processo de desenvolvimento esteja sempre atualizado, lembre-se de executar o seguinte comando na branch dev antes de criar uma branch nova:

git pull origin develop

Criando branchs

Para criar uma nova branch, execute o comando:

git checkout -b <nomeDaBranch>

Por exemplo:

git checkout -b feature/progress-bar-component

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 comando git push

git push 

Merge Requests

Assim que uma tarefa for finalizada execute o seguinte comando:

git pull origin develop

O mesmo irá garantir que sua branch está atualizada com a branch develop (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 develop.
• Título: <nome da tarefa>
• 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 ClickUp para "Review" e avise um AGES 3, AGES 4.