FAQ — GitHub Classroom

Bem-vindo(a)! Este repositório reúne as principais dúvidas e o passo a passo para que os alunos do IFPE Paulista possam usar o GitHub Classroom nas atividades práticas das disciplinas.

---

Sumário

1. O que é o GitHub Classroom?
2. Pré-requisitos
3. Aceitando uma atividade
4. Clonando o repositório da atividade
5. Trabalhando na atividade
6. Enviando (submetendo) a atividade
7. Verificando a entrega e o feedback automático
8. Perguntas Frequentes

---

1. O que é o GitHub Classroom?

O GitHub Classroom é uma ferramenta que permite ao professor distribuir atividades de programação por meio de repositórios individuais (ou em grupo) no GitHub. Cada aluno recebe seu próprio repositório privado para resolver e entregar a tarefa.

---

2. Pré-requisitos

Antes de começar, certifique-se de ter:

• Conta no GitHub — crie gratuitamente em https://github.com/signup
• Git instalado na sua máquina — https://git-scm.com/downloads
• (Opcional) GitHub Desktop para uma interface gráfica — https://desktop.github.com/
• (Opcional) VS Code com a extensão GitHub Pull Requests and Issues

Dica: Use o e-mail institucional ao criar sua conta no GitHub para ter acesso ao GitHub Education, que oferece benefícios gratuitos para estudantes.

---

3. Aceitando uma atividade

1. O professor enviará um link de convite da atividade (algo como https://classroom.github.com/a/XXXXXXXX).
2. Abra o link no navegador e faça login na sua conta do GitHub.
3. Se for a primeira vez nessa organização, autorize o GitHub Classroom a acessar sua conta.
4. Associe seu nome de usuário GitHub ao seu nome na lista da turma (feito apenas uma vez por organização).
5. Clique em "Accept this assignment".
6. Aguarde alguns segundos enquanto o GitHub cria o seu repositório. Recarregue a página se necessário.
7. Quando estiver pronto, você verá o link do seu repositório pessoal — guarde-o!

---

4. Clonando o repositório da atividade

Com o repositório criado, clone-o para a sua máquina local:

git clone https://github.com/<organização>/<nome-do-repositório>.git

Substitua a URL pela exibida na página do seu repositório. Depois entre na pasta criada:

cd <nome-do-repositório>

Alternativa com GitHub Desktop: clique em "Code" → "Open with GitHub Desktop" na página do repositório.

---

5. Trabalhando na atividade

Edite os arquivos conforme as instruções da atividade. Sempre que atingir um ponto de progresso relevante, salve seu trabalho com commits:

# Adiciona todos os arquivos modificados à área de stage
git add .

# Cria um commit com uma mensagem descritiva
git commit -m "Implementa função de ordenação"

Boas práticas de commit:

• Faça commits pequenos e frequentes.
• Escreva mensagens claras no imperativo (ex.: "Adiciona testes unitários").
• Nunca commite arquivos desnecessários (senhas, .env, arquivos de build, etc.).

---

6. Enviando (submetendo) a atividade

Para enviar suas alterações ao GitHub (e, portanto, ao professor), execute:

git push origin main

Se o branch padrão do repositório for master em vez de main, use git push origin master.

Você pode enviar quantas vezes quiser antes do prazo. O professor avaliará o último commit antes do encerramento da atividade.

---

7. Verificando a entrega e o feedback automático

1. Acesse o repositório no GitHub pelo link que você recebeu no passo 3.
2. Clique na aba "Actions" para ver se há testes automáticos configurados pelo professor.
3. Um ícone verde ✅ indica que os testes passaram; vermelho ❌ indica falhas — clique para ver os detalhes.
4. Feedback do professor pode aparecer como comentários em Pull Requests ou Issues dentro do repositório.

---

8. Perguntas Frequentes

❓ Esqueci de aceitar a atividade. O que faço?

Entre em contato com o professor e peça o link de convite novamente. O link pode expirar ou ter limite de usos.

❓ Cometi um erro no último commit. Como corrijo?

Se ainda não fez push, corrija os arquivos e use:

git add .
git commit --amend -m "Mensagem corrigida"

Se já fez push, corrija, crie um novo commit e envie novamente — o histórico ficará registrado, o que é normal.

❓ O git push pediu usuário e senha. O que usar?

O GitHub não aceita mais senha convencional. Use um Personal Access Token (PAT):

1. Acesse Settings → Developer settings → Personal access tokens → Tokens (classic).
2. Gere um token com escopo repo.
3. Use o token no lugar da senha ao fazer push.

Ou configure autenticação via SSH: https://docs.github.com/pt/authentication/connecting-to-github-with-ssh

❓ Posso trabalhar com colegas no mesmo repositório?

Isso depende da configuração da atividade. Se o professor criou uma atividade em grupo, você poderá convidar colegas. Para atividades individuais, o repositório é pessoal.

❓ Meu repositório sumiu ou aparece como "Not Found". O que faço?

Verifique se você está logado com a conta correta no GitHub. Se o problema persistir, fale com o professor.

❓ Posso fazer fork do repositório base?

Não é necessário. O GitHub Classroom já cria uma cópia individual para você automaticamente ao aceitar a atividade.

❓ O prazo da atividade passou. Ainda posso fazer push?

O repositório continuará aberto para commits após o prazo, mas o professor avaliará o estado do repositório no horário de encerramento. Confirme com o professor se commits tardios serão considerados.

---

Recursos Úteis

• 📖 Documentação oficial do Git (PT-BR)
• 🎓 GitHub Skills — aprenda Git e GitHub de graça
• 🆘 Suporte do GitHub

---

Em caso de dúvidas não respondidas aqui, abra uma Issue neste repositório ou entre em contato com seu professor.