Contexto
Atualmente, o repositório não possui um template padrão para abertura de Issues. Cada issue pode ser criada com uma estrutura diferente, o que pode resultar em informações incompletas, falta de contexto e maior esforço para compreender o problema ou a solicitação proposta.
Hoje, parte das issues abertas pela @m4rri4nne e @stherzada já segue uma estrutura bem definida, contendo informações como descrição do problema, passos para reprodução, comportamento esperado, causa raiz, sugestão de correção e contexto adicional. Entretanto, esse padrão depende de quem está criando a issue e não é aplicado de forma consistente para todos os contribuidores.
Além de padronizar as informações, o template também serve como um guia para novos contribuidores. Como a comunidade incentiva a participação de pessoas com diferentes níveis de experiência, fornecer uma estrutura pré-definida reduz dúvidas sobre quais informações incluir e melhora a comunicação entre contribuidores, revisores e mantenedores.
Com essa padronização, espera-se:
- Melhorar a qualidade das informações fornecidas desde a abertura da Issue;
- Facilitar a triagem;
- Reduzir a necessidade de solicitar informações complementares;
- Tornar as discussões mais objetivas e produtivas;
- Evoluir o processo de contribuição da organização com um padrão consistente para todos.
Contexto
Atualmente, o repositório não possui um template padrão para abertura de Issues. Cada issue pode ser criada com uma estrutura diferente, o que pode resultar em informações incompletas, falta de contexto e maior esforço para compreender o problema ou a solicitação proposta.
Hoje, parte das issues abertas pela @m4rri4nne e @stherzada já segue uma estrutura bem definida, contendo informações como descrição do problema, passos para reprodução, comportamento esperado, causa raiz, sugestão de correção e contexto adicional. Entretanto, esse padrão depende de quem está criando a issue e não é aplicado de forma consistente para todos os contribuidores.
Além de padronizar as informações, o template também serve como um guia para novos contribuidores. Como a comunidade incentiva a participação de pessoas com diferentes níveis de experiência, fornecer uma estrutura pré-definida reduz dúvidas sobre quais informações incluir e melhora a comunicação entre contribuidores, revisores e mantenedores.
Com essa padronização, espera-se: