O que é issue?
Issue é um registro de problema, pedido de melhoria ou tarefa dentro de um projeto de software, geralmente em plataformas como o GitHub. Serve para acompanhar o que precisa ser corrigido ou criado.
Na prática, quem usa o projeto abre uma issue descrevendo um bug, uma sugestão ou uma dúvida. Os mantenedores podem comentar, marcar com etiquetas, atribuir a alguém e fechar a issue quando o assunto for resolvido, deixando todo o histórico registrado num só lugar.
Uma analogia simples é pensar em um quadro de recados de um condomínio, onde cada aviso traz um problema, quem está cuidando dele e o que já foi feito. Assim, ninguém precisa lembrar de cabeça o que está pendente.
Ter issues bem escritas facilita a colaboração e evita que problemas importantes se percam. Ao reportar um problema, vale descrever com clareza o que aconteceu, como reproduzir e qual era o resultado esperado, sem incluir dados sensíveis como senhas ou chaves de acesso.