Guia de Contribuição

Este guia descreve o fluxo de trabalho para contribuir com o projeto. O processo é simples e foi pensado para facilitar a organização e o acompanhamento das tarefas.

---

Passos para Contribuir

1. Antes de começar

Certifique-se de que você tem acesso ao repositório e às tarefas no Jira. Caso não tenha, envie uma mensagem no WhatsApp para o responsável do projeto para configurar seu acesso.

2. Clonando o repositório

Antes de começar a trabalhar, é necessário clonar o projeto do repositório remoto para sua máquina local. Você pode fazer isso de duas formas: usando o terminal ou uma ferramenta gráfica.

Usando o terminal:

1. Faça login no GitHub com o comando gh auth (se ainda não tiver feito):

   gh auth login

2. Copie o link HTTPS ou SSH do repositório no GitHub.
3. No terminal, use o comando:

   git clone URL-DO-REPOSITORIO

   Exemplo:

   git clone https://github.com/usuario/projeto.git

Usando o GitHub Desktop (para quem prefere evitar o terminal):

1. Baixe e instale o GitHub Desktop.
2. Faça login na sua conta GitHub.
3. No repositório, clique em Code e escolha a opção Open with GitHub Desktop.
4. Siga as instruções para clonar o projeto.

---

3. Criando uma branch para a sua tarefa

Antes de começar o desenvolvimento, crie uma nova branch com base na branch main. A nomenclatura deve seguir o seguinte padrão:

ID-DO-CARD-NO-JIRA/breve-descricao

Exemplo: Para a tarefa "Desenvolver cabeçalho" com o ID SC-7 no Jira, sua branch deve ser nomeada como:

SC-7/desenvolver-cabecalho

Comandos Git:

1. Certifique-se de estar na branch main:

   git checkout main

2. Atualize a branch main local com a versão mais recente do repositório remoto:

   git pull origin main

3. Crie e mude para a nova branch:

   git checkout -b ID-DO-CARD-NO-JIRA/breve-descricao

   Exemplo real:

   git checkout -b SC-7/desenvolver-cabecalho

Log: Adicionado comando para criar uma nova branch.

4. Desenvolvendo a tarefa

Trabalhe na branch que você criou, implementando as alterações necessárias. Faça commits com mensagens claras e explicativas sobre o que foi feito.

Comandos Git:

1. Adicione os arquivos alterados ao commit:

   git add .

2. Faça o commit com uma mensagem clara:

   git commit -m "[ID-DO-CARD] Breve descrição do que foi feito"

   Exemplo:

   git commit -m "[SC-7] Desenvolvido cabeçalho inicial"

3. Envie suas alterações para o repositório remoto:

   git push origin ID-DO-CARD-NO-JIRA/breve-descricao

   Exemplo:

   git push origin SC-7/desenvolver-cabecalho

Log: Adicionado comando para fazer commit e enviar alterações.

5. Criando uma Pull Request

Quando terminar o desenvolvimento da sua tarefa:

1. Acesse o repositório no GitHub ou GitLab.
2. Localize a sua branch no menu de branches.
3. Clique em New Pull Request (ou equivalente).
4. Certifique-se de que a base da Pull Request é a branch main.
5. Inclua uma descrição clara do que foi implementado.
6. Envie a Pull Request para análise.

Log: Pull Request criada.

6. Movimentando o card no Jira

Após criar a Pull Request, mova o card correspondente no Jira para a coluna Aguardando Aprovação.

---

Resumo do Fluxo

1. Clone o projeto: git clone URL-DO-REPOSITORIO ou use o GitHub Desktop.
2. Crie uma branch: git checkout -b ID-DO-CARD-NO-JIRA/breve-descricao.
3. Implemente e commite suas mudanças: git add . e git commit -m "[ID-DO-CARD] Breve descrição".
4. Envie para o repositório remoto: git push origin ID-DO-CARD-NO-JIRA/breve-descricao.
5. Crie a Pull Request.
6. Atualize o status no Jira.

---

Em caso de dúvidas, entre em contato com o responsável pelo projeto. Estamos aqui para ajudar!

Log: Atualizado status no Jira.