3.6.5 Colaboração com GitHub

🤝 Colaboração com GitHub

---

🧠 O que significa colaborar com GitHub?

É quando várias pessoas trabalham no mesmo projeto, ao mesmo tempo, de forma organizada, sem bagunçar o código umas das outras.

💡 GitHub é como um Google Docs para código, mas com:

• Controle de versão (sabe quem mexeu, quando e o quê)

• Revisões antes de aceitar mudanças (Pull Requests)

• Divisão de tarefas por branch

---

👥 Como funciona um time no GitHub?

Papel	O que faz
Dono do repo	Cria o projeto, organiza as branches, aprova os PRs
Contribuidor	Cria branches, desenvolve, abre Pull Requests
Revisor	Analisa o código de outros, comenta, aprova ou pede ajustes

---

🛠️ Etapas da colaboração

1. 🚀 Alguém cria o repositório

• Pode ser organização, equipe ou um amigo

• Define se será público ou privado

• Dá permissão de escrita para quem for colaborar

---

2. 🌿 Cada pessoa trabalha em uma branch

git checkout -b feature/nova-secao

• A branch serve para separar tarefas

• Pode ser: feature/menu, hotfix/erro-footer, ajuste-imagem, etc

---

3. 🔄 Faz commits locais e envia ao GitHub

git add .
git commit -m "Cria nova seção de serviços"
git push origin feature/nova-secao

---

4. 📤 Cria um Pull Request

• Vai no GitHub

• Clica em “Compare & pull request”

• Escreve o que fez

• Marca alguém para revisar (ex: @amigo)

---

5. ✅ Revisor aprova ou pede ajustes

• Pode comentar trechos específicos do código

• Se aprovado: merge na main

• Se precisar melhorar: volta pra branch, edita e envia de novo

---

6. 🧼 Após o merge, branch pode ser deletada

git branch -d feature/nova-secao     # local
git push origin --delete feature/nova-secao  # remoto

---

🧃 Analogia: GitHub como uma cozinha

Situação real	No GitHub
Cada um faz seu prato	Cada um faz uma branch
Alguém revisa o tempero	Revisor avalia Pull Request
Só leva à mesa o aprovado	Só entra no main o que for bom
Todo mundo come junto	Projeto atualizado pra todo mundo

---

💬 Comunicação no GitHub

• Use Pull Requests para discutir o que foi feito

• Comente com @nomedapessoa para marcar alguém

• Use issues para organizar tarefas

• Escreva mensagens de commit CLARAS

---

📌 Boas práticas de colaboração

Dica	Por quê
Não trabalhe direto na main	Evita bagunça no projeto principal
Use branches com nomes claros	Facilita entender o que está sendo feito
Escreva commits descritivos	Ex: corrige botão quebrado no mobile
Atualize sua branch com main antes do PR	Evita conflito no merge
Sempre revise o código de colegas	Código em equipe = responsabilidade em equipe 💪

---

🏁 Desafio prático de colaboração

1. Você e um amigo criam um repositório juntos

2. Cada um faz uma branch (joao-pagina1, maria-pagina2)

3. Cada um faz commit e push

4. Cada um abre um Pull Request

5. Um revisa o PR do outro

6. Fazem merge e deletam as branches