📋 Aula 12 · GitHub

Issues: organizando o trabalho

Antes de sair programando, é bom saber o que precisa ser feito. As Issues do GitHub são o lugar para registrar tarefas, bugs e ideias do projeto.

🎫 O que é uma Issue

Um registro para cada assunto

🐞

Bug

Algo que está com defeito e precisa ser corrigido.

✨

Melhoria

Uma nova funcionalidade ou algo para aperfeiçoar.

❓

Dúvida ou tarefa

Uma pergunta ou um item de trabalho a organizar.

🔑Uma Issue é uma conversa registrada sobre algo a fazer no projeto.

➕ Criando uma Issue

Na aba Issues do repositório

1 Abrir a aba Issues → New issue no topo do repositório
2 Escrever um título claro (ex.: “Adicionar seção de contato no README”)
3 Descrever o contexto e o resultado esperado
4 Clicar em Submit new issue — a Issue ganha um número (ex.: #12)

🏷️ Organizando as Issues

Labels e responsáveis

🏷️

Labels

Etiquetas coloridas como bug, enhancement ou documentation para classificar.

👤

Assignees

Quem é responsável por resolver aquela Issue.

🎯

Milestones

Agrupam Issues por objetivo ou entrega (veremos em projetos maiores).

🔑Labels e responsáveis deixam claro o que é cada tarefa e quem cuida dela.

🔗 Ligando Issues ao código

Feche uma Issue pelo commit

mensagem de commit que fecha a Issue #12

git commit -m "Adiciona seção de contato · Closes #12"# ao chegar na main, o GitHub fecha a Issue #12 automaticamente

🔑Escrever #12 cria um link para a Issue; Closes #12 a fecha quando o Pull Request é integrado.

🧭 Issues antes das branches

Planejar, depois programar

1 Abrir a Issue registrando a tarefa
2 Criar a branch para resolver aquela Issue
3 Abrir o Pull Request com Closes #N na descrição
4 O merge fecha a Issue automaticamente

🔑Issues transformam “o que preciso fazer” em passos organizados antes do código.

🎯 Prática guiada

Abra sua primeira Issue

✅ Abrir a aba Issues do seu repositório e clicar em New issue.
✅ Escrever um título e uma descrição claros.
✅ Aplicar uma label (ex.: documentation).
✅ Atribuir a Issue a você mesma em Assignees.

🏁 Encerramento

Trabalho organizado, equipe alinhada

Com Issues, qualquer pessoa entende o que precisa ser feito, o que está em andamento e o que já foi concluído — mesmo em projetos com muita gente.

💡

Você sabia?

Projetos open source usam Issues para receber sugestões da comunidade. Muitas pessoas começam a contribuir justamente resolvendo uma Issue marcada como good first issue.

➡️Próxima aula: o que é uma branch e por que ela existe.