3 - Mão na massa

🧠 Como entender Pull Request de forma simples?

🧃 Analogia: Suco na geladeira do time

Você tem uma receita de suco (código) que quer colocar na geladeira da equipe (main branch).

Mas… Antes de colocar lá, você avisa no grupo:

“Gente, fiz um suco novo aqui. Confere se tá bom pra colocar com os outros.”

Esse pedido de revisão é o Pull Request.

---

🎮 Simulação de Pull Request do zero

🧪 Agora vamos imaginar que você está em um time de 3 pessoas num projeto no GitHub.

✅ O que cada pessoa faz

Pessoa	Papel
Você	Cria uma branch e faz o código
Colega 1	Revisa o código
Colega 2	Dá o merge no main se estiver tudo ok

---

🔄 Passo a passo real no GitHub

1. Clone o repositório do time

   git clone https://github.com/time/repo.git
   cd repo

2. Crie uma branch nova para sua tarefa

   git checkout -b feature/banner

3. Adicione o arquivo banner.html

   git add .
   git commit -m "Adiciona banner principal"

4. Envie sua branch

   git push origin feature/banner

5. No GitHub, clique em "Compare & pull request"

6. Preencha o PR com:

   • Título: Adiciona banner principal

   • Corpo: Esse PR adiciona um banner de destaque na home com link para o produto em promoção.

7. Crie o Pull Request

---

🧪 Após o PR criado...

O GitHub cria uma tela como esta:

╔══════════════════════════════╗
║  🔄 Pull Request: feature/banner  ║
╚══════════════════════════════╝

👤 por você      📂 para main

💬 Comentários
✅ Passou nos testes (CI/CD)
👀 Aguardando revisão

---

💬 E o que os outros fazem?

• 👀 Eles leem o que foi feito.

• 💬 Comentam se algo estiver estranho.

• ✅ Se aprovado, clicam em “Merge pull request”.

---

🔧 O que acontece depois do merge?

• Sua branch entra no main.

• Todo mundo do time agora tem acesso ao que você fez.

• Você pode deletar a branch (limpar a bagunça).

git checkout main
git pull origin main
git branch -d feature/banner

---

🚨 Erros comuns de iniciantes com Pull Request

❌ Trabalhar direto na main ❌ Fazer PR sem testar o código ❌ Nomear PR de forma genérica ("Update", "testes") ❌ Não escrever descrição nenhuma ❌ Não atualizar sua branch com o main antes do merge

---

🏁 Desafio prático (pode fazer com amigo)

1. Crie um repositório no GitHub com um arquivo index.html.

2. Peça para um amigo clonar e criar uma branch chamada feature/footer.

3. Ele adiciona um rodapé e faz push da branch.

4. Ele cria um Pull Request no GitHub.

5. Você revisa, comenta e aprova.

6. Ele faz o merge e deleta a branch.

✅ Parabéns! Vocês simularam um fluxo de trabalho real em equipe.

---

Se quiser, posso gerar cards visuais com exemplos bons e ruins de Pull Request, ou um mini-tutorial com imagens estilo apostila. Deseja isso?