Dinâmica: Colaboração Coder – Desafio GitHub em Equipe

Bem-vindos, futuros desenvolvedores! Nesta atividade, vamos colocar a mão na massa e aprender como colaborar em projetos de software usando ferramentas profissionais como GitHub, Organizações, Equipes e o GitHub Desktop.

Preparem-se para trabalhar em equipe, resolver desafios e construir algo juntos!

Objetivos da Missão

Ao final desta atividade, você será capaz de:

• Entender por que usamos Organizações no GitHub para projetos em grupo.
• Ajudar a gerenciar Equipes e suas permissões.
• Usar o GitHub Desktop para:
  • Clonar projetos.
  • Criar seus próprios branches (ramos de trabalho).
  • Salvar seu progresso com commits.
  • Enviar suas contribuições (push).
• Criar e revisar Pull Requests (pedidos para integrar seu código).
• (Bônus) Aprender a lidar com pequenos conflitos de código.

O que você precisa ter pronto?

• Uma conta no GitHub (se ainda não tem, crie em github.com).
• GitHub Desktop instalado no seu computador (baixe em desktop.github.com).
• Acesso à internet.
• Muita vontade de colaborar e aprender!

Fase 1: Preparativos e Formando as Grupos (20-30 minutos)

Nesta fase, seu instrutor irá preparar o campo de batalha!

1. Entrando na Organização:
   • O Prof. Washington criou uma Organização no GitHub para essa atividade (algo como DesafioColaborativo-TDS2-2025).
   • Forneça seu nome de usuário do GitHub ao prof. Washington.
   • Atenção: Você receberá um convite por e-mail ou uma notificação no GitHub. Aceite o convite para entrar na Organização!
2. Formando sua Equipe e Conhecendo o Projeto:
   • A turma será dividida em equipes (3-4 pessoas). Escolham um nome bem criativo para sua equipe!
   • Oprof. Washington criará as Equipes dentro da Organização e adicionará você e seus colegas.
   • Um Repositório chamado ProjetoReadmeColaborativo será criado pelo prof. Washington. É neste projeto que vamos trabalhar!
     • Ele começará com um arquivo README.md básico:
     • # Projeto Readme Colaborativo Bem-vindo ao nosso projeto colaborativo! O objetivo é construir este README em equipe. ## Como Começar 1. Clone este repositório. 2. Crie um branch para sua tarefa. 3. Faça suas modificações. 4. Envie um Pull Request! ## Seções a Adicionar: *(Esta parte será preenchida pelas equipes)*
   • Sua equipe terá permissão de Write (escrita) neste repositório. Isso significa que vocês poderão enviar suas contribuições!

Fase 2: O Desafio Começa! (40-50 minutos)

Agora é hora de mostrar suas habilidades!

1. Sua Missão (Tarefa da Equipe):
   • O prof. Washington designará uma tarefa específica para sua equipe. O objetivo é adicionar uma nova seção ao arquivo README.md do ProjetoReadmeColaborativo.
   • Exemplos de Tarefas (sua equipe receberá UMA):
     • Equipe 1 (MeowTech): Adicionar uma seção “### Funcionalidades Imaginárias do Projeto” com uma lista de 3 funcionalidades fictícias que este “projeto” teria.
     • Equipe 2 (TDCF): Adicionar uma seção “### Nossa Equipe Incrível” listando os nomes (ou usernames do GitHub) dos membros da sua equipe.
     • Equipe 3 (N4): Adicionar uma seção “### Tecnologias que Usaríamos” com uma lista de 3 tecnologias (linguagens, frameworks, etc.) que seriam usadas neste projeto fictício.
     • Equipe 4 (SOWE): Adicionar uma seção “### Objetivos do Projeto Readme” com 2-3 objetivos para a construção deste README colaborativo.
     • Equipe 5 (CodeTrio): Adicionar uma seção “### Prazos do Projeto Readme” com os prazos para a execução do projeto colaborativo.
     • Equipe 6 (SCCP): Adicionar uma seção “### Requisitos do Projeto Readme” com 2-3 requisitos funcionais para a construção deste README colaborativo.
     • Equipe 7 (BadTzMaru): Adicionar uma seção “### Requisitos NF do Projeto Readme” com 2-3 requisitos não funcionais para a construção deste README colaborativo.
     • Equipe 8 (SHIMADA): Adicionar uma seção “### Custos do Projeto Readme” com os custos de desenvolvimento para a construção deste README colaborativo.
2. Mãos à Obra (Passo a Passo Individual ou em Dupla):Use o GitHub Desktop para os passos seguintes:
   • Passo 1: Clonar o Repositório
     • Abra o GitHub Desktop.
     • Vá em File > Clone Repository....
     • Na aba da Organização (DesafioColaborativo-...), selecione o repositório ProjetoReadmeColaborativo.
     • Escolha uma pasta no seu computador para salvar o projeto e clique em “Clone”.
   • Passo 2: Criar seu Branch (Ramificação) de Trabalho
     • Verifique se o “Current Branch” (Branch Atual) no topo do GitHub Desktop está como main.
     • Clique em Current Branch > New Branch....
     • Dê um nome para seu branch seguindo o padrão: [nome-da-sua-equipe]/[descricao-da-tarefa] (Ex: eq1/add-secao-funcionalidades ou, se preferir, [seu-username]/add-secao-funcionalidades).
     • Clique em “Create Branch”.
     • Importante: Logo em seguida, clique em “Publish branch”. Isso envia seu novo branch (ainda sem suas alterações) para o GitHub.
   • Passo 3: Fazer as Alterações
     • Abra o arquivo README.md (que está na pasta do projeto que você clonou) usando seu editor de texto preferido (VS Code, Bloco de Notas, etc.).
     • Adicione a seção e o conteúdo que foram designados para sua equipe.
     • Salve o arquivo!
   • Passo 4: Fazer o Commit (Salvar seu Progresso)
     • Volte para o GitHub Desktop. Suas modificações no README.md aparecerão na aba “Changes” (Alterações) à esquerda.
     • No campo “Summary” (Resumo), no canto inferior esquerdo, escreva uma mensagem clara sobre o que você fez (Ex: “Adiciona seção de Funcionalidades Imaginárias”).
     • Clique no botão Commit to [nome-do-seu-branch].
   • Passo 5: Enviar para o GitHub (Push)
     • Clique no botão Push origin (geralmente no topo da interface do GitHub Desktop). Isso envia seus commits para o seu branch no GitHub.
3. Criando o Pull Request (PR) – Pedindo para Integrar seu Trabalho
   • Após fazer o “Push”, o GitHub Desktop pode mostrar um atalho “Create Pull Request”. Clique nele! (Ou vá diretamente para a página do repositório ProjetoReadmeColaborativo no site do GitHub – um aviso para criar o PR deve aparecer lá).
   • Na página de criação do Pull Request no GitHub:
     • Título: Dê um título claro (Ex: “Feature: Adiciona Seção de Funcionalidades”).
     • Descrição: Escreva uma breve explicação do que você fez.
     • base branch (branch base) deve ser main.
     • compare branch (branch de comparação) deve ser o seu branch.
     • Revisores (Reviewers): 📢 MUITO IMPORTANTE! Sua equipe deve solicitar a revisão de membros de PELO MENOS UMA OUTRA EQUIPE. Seu instrutor ajudará a coordenar quem revisa o quê.
     • Clique em “Create Pull Request”.

Fase 3: Olho Crítico e Colaboração (20-30 minutos)

Agora é hora de revisar o trabalho dos colegas e receber feedback sobre o seu!

1. Revisando o Código dos Colegas (Peer Review):
   • Você será notificado (ou pode checar na aba “Pull Requests” do repositório) quando for designado para revisar um PR.
   • Sua Missão como Revisor:
     1. Abra o Pull Request.
     2. Vá na aba “Files changed” para ver o que foi alterado.
     3. Deixe pelo menos um comentário construtivo! Pode ser uma sugestão, uma pergunta para esclarecer algo, ou um elogio. O objetivo é ajudar o colega e melhorar o projeto.
     4. Se estiver tudo certo, clique em Review changes > Approve (Aprovar). Se você acha que algo precisa ser corrigido, clique em Request changes (Solicitar alterações) e explique o que precisa ser ajustado.
2. Recebendo e Aplicando Feedback (se seu PR foi revisado):
   • Se seu Pull Request recebeu solicitações de mudança:
     1. Leia os comentários e faça as correções necessárias no seu branch local (no arquivo README.md).
     2. Faça um novo Commit e Push origin novamente (como você fez na Fase 2, Passos 4 e 5).
     3. Seu Pull Request no GitHub será atualizado automaticamente, e os revisores serão notificados.
3. Merge dos Pull Requests (Unindo Tudo! – Instrutor)
   • Quando um Pull Request for aprovado pelos revisores:
     • O instrutor (ou um aluno designado) fará o “Merge” do seu PR. Isso significa que suas contribuições serão oficialmente adicionadas ao projeto principal (main)!
     • Após o merge, o branch que você criou para sua tarefa pode ser deletado (o GitHub geralmente oferece essa opção).

Fase 4: Eita, Conflito! (Opcional – 10-15 minutos)

Às vezes, duas pessoas mexem na mesma parte do arquivo ao mesmo tempo. Isso pode gerar um “conflito”! Se acontecer:

• O GitHub ou o GitHub Desktop avisarão.
• Seu instrutor mostrará como:
  • Abrir o arquivo conflitante.
  • Ver os marcadores que o Git coloca para mostrar onde está o conflito:<<<<<<< HEAD [O que está no seu branch/main] ======= [O que está vindo do outro branch] >>>>>>> [nome-do-outro-branch]
  • Vocês discutirão como decidir qual versão manter ou como combinar as duas.
  • Depois de editar o arquivo para resolver o conflito e salvar, você fará um novo Commit e Push.

Fase 5: O que Aprendemos? (10 minutos)

Vamos conversar em grupo:

• O que você achou da atividade? Foi divertido? Desafiador?
• O que foi mais difícil?
• Como ter uma Organização e Equipes no GitHub pode ajudar em projetos reais?
• O GitHub Desktop facilitou o uso do Git? Como?
• Por que revisar o código dos colegas (Pull Requests) é importante?
• Você consegue imaginar como esse jeito de trabalhar é usado nas empresas de software?

Parabéns por completar o Desafio Colaboração Coder! Você deu um grande passo para se tornar um desenvolvedor colaborativo!