3.5.2 Pull Request

🔄 Pull Request (PR) — Colaboração com Segurança

---

🧠 O que é um Pull Request?

Um Pull Request (PR) é quando você pede para o GitHub (ou GitLab, Bitbucket etc.) verificar, revisar e juntar o seu código com o principal (geralmente o main).

É como dizer:

“Ei, terminei meu trabalho aqui! Alguém pode revisar e aprovar antes de juntar?”

📌 É o coração do trabalho em equipe com Git.

---

🤝 Por que usar Pull Request?

✔ Evita que código com erro vá direto pro projeto. ✔ Garante revisão de alguém mais experiente. ✔ Mantém o histórico limpo e organizado. ✔ Facilita testes e comentários no código. ✔ Garante que o main sempre esteja funcionando.

---

🧪 Como funciona (passo a passo real)

1. Faça uma branch nova

git checkout -b feature/nome-da-tarefa

2. Trabalhe normalmente

git add .
git commit -m "Implementa a funcionalidade X"

3. Envie essa branch para o GitHub

git push origin feature/nome-da-tarefa

4. Vá até o repositório no GitHub

⚡ O GitHub vai mostrar um botão:

“Compare & pull request”

Clique nele.

---

✍️ Como preencher um Pull Request

1. Título: Descreva de forma simples. Exemplo: "Criação da página de contato"

2. Descrição (corpo): Explique:

   • O que foi feito?

   • Por que foi feito?

   • Algum detalhe importante?

3. Checklist opcional:

   • Código testado

   • Sem conflitos

   • Commit com mensagem clara

4. Clique em Create Pull Request.

---

👀 O que acontece depois?

• Alguém revisa o seu PR.

• Pode aprovar, pedir ajustes ou sugerir melhorias.

• Você pode comentar, editar ou mudar o código.

• Quando estiver tudo certo → merge no main.

---

💬 Quem pode aprovar?

Depende das permissões do projeto:

Quem é você?	Pode aprovar?
Dono ou admin do repo	✅ Sim
Colaborador com acesso	✅ Sim
Alguém de fora (fork)	❌ Não, só pedir PR

---

⚠️ Dicas de boas práticas

• Sempre trabalhe em branch separada.

• Faça commits pequenos e com mensagens claras.

• Não envie arquivos desnecessários (ex: .env, .DS_Store, .vscode).

• Antes de dar push:

  git pull origin main

  pra evitar conflito.

---

🛠️ Comando útil para revisar Pull Request localmente

Quer testar a PR antes de aprovar?

git fetch origin pull/ID/head:nome-da-pr
git checkout nome-da-pr

(Substitua ID pelo número do PR, ex: pull/17/head:minha-pr)

---

✅ Conclusão simples

| O que é? | Um pedido para juntar sua branch com o projeto principal. | | Por que usar? | Segurança, revisão, histórico limpo. | | Quem faz? | Quem desenvolve uma feature. | | Quem aprova? | Outro membro com permissão. |