🧠 Git e GitHub em equipe
🧭 1. Clonar o repositório
**Serve para:** Copiar o projeto hospedado no GitHub para sua máquina local.
Isso cria uma cópia exata do repositório remoto para que você possa trabalhar no código localmente.
---
🌿 2. Criar uma nova branch para sua tarefa
**Serve para:** Trabalhar isoladamente em uma funcionalidade, sem afetar o código principal.
Evita conflitos e facilita o trabalho paralelo em equipe.
Cada funcionalidade/correção deve ser feita em uma branch separada.
---
🛠️ 3. Fazer alterações no código
**Serve para:** Implementar as funcionalidades, correções ou melhorias que você ficou responsável.
É aqui que você realmente programa no seu editor (VS Code, por exemplo).
---
💾 4. Adicionar e commitar suas mudanças
**Serve para:** Salvar um conjunto de alterações no histórico do Git.
- `git add`: seleciona os arquivos alterados que você quer guardar.
- `git commit`: registra essas alterações com uma mensagem explicando o que foi feito.
---
🚀 5. Enviar sua branch para o GitHub
**Serve para:** Enviar suas mudanças da máquina local para o GitHub (repositório remoto).
Isso torna seu trabalho visível para os outros membros da equipe.
---
🔁 6. Abrir um Pull Request (PR)
**Serve para:** Pedir que sua branch seja revisada e mesclada com a principal.
O GitHub oferece uma interface para isso.
Você descreve o que fez e solicita uma revisão.
---
👀 7. Revisão de código
**Serve para:** Garantir que o código está correto, limpo e segue os padrões do projeto.
Outros membros podem aprovar, comentar ou pedir mudanças antes do merge.
---
🔀 8. Merge na branch principal
**Serve para:** Unir sua branch (com a nova funcionalidade) à branch principal (`main` ou `master`).
Após a aprovação, você faz o merge para atualizar o projeto oficial.
---
🔄 9. Atualizar seu repositório local
**Serve para:** Garantir que você tem a versão mais recente do código no seu computador.
Especialmente importante após um merge para continuar trabalhando com a base atualizada.
---
🧹 10. Deletar a branch (opcional, mas recomendado)
**Serve para:** Limpar branches que não são mais necessárias após o merge.
Ajuda a manter o repositório organizado e evitar confusão.
---
✅ PASSO A PASSO
🧭 1. Clonar o repositório
Você precisa clonar o repositório remoto para sua máquina local:
git clone https://github.com/usuario/nome-do-repositorio.git
cd nome-do-repositorio
---
🌿 2. Criar uma nova branch para sua tarefa
Sempre crie uma branch nova para cada funcionalidade ou correção:
git checkout -b nome-da-sua-branch
🛠️ 3. Fazer alterações no código
Edite os arquivos conforme necessário no seu editor de código (ex: VS Code).
---
💾 4. Adicionar e commitar suas mudanças
Depois de fazer alterações:
git add .
git commit -m "feat: adiciona cadastro de usuário"
---
🚀 5. Enviar sua branch para o GitHub
Isso publica sua branch no repositório remoto:
git push origin nome-da-sua-branch
---
🔁 6. Abrir um Pull Request (PR)
- Vá até o GitHub
- Clique em "Compare & pull request"
- Adicione uma descrição clara do que foi feito
- Marque revisores, se necessário
---
👀 7. Revisão de código
- Colegas revisam seu PR
- Podem sugerir mudanças ou aprovar
---
🔀 8. Merge na branch principal
Após aprovação, o PR é mesclado na main (pode ser automático ou feito por alguém com permissão):
No GitHub: clique em "Merge pull request"
---
🔄 9. Atualizar seu repositório local
Depois que o PR for mesclado, atualize sua main local:
git checkout main
git pull origin main`
---
🧹 10. Deletar a branch (opcional, mas recomendado)
Após o merge, você pode excluir a branch:
git branch -d nome-da-sua-branch
