Este é um guia para relatar bugs que você encontrar no Discourse usando os canais corretos.
Nível de usuário necessário: Qualquer pessoa pode relatar bugs
Quando você se depara com um problema que quebra ou impede o uso normal do Discourse, é crucial relatar esse bug para que ele possa ser abordado e corrigido. Relatar bugs ajuda a melhorar a plataforma para todos - esta documentação irá guiá-lo através do processo de relatar um bug de forma eficaz no Meta, uma ótima maneira de contribuir para o Discourse.
Resumo
Neste guia, você aprenderá:
- Como garantir que o bug já não foi resolvido
- Como validar o problema no ambiente de teste oficial do Discourse
- Como criar um relatório de bug detalhado
Garantindo que o bug já não foi resolvido
Antes de relatar um bug, pesquise na categoria de bugs no Meta por problemas semelhantes para garantir que ele ainda não foi relatado. Isso ajuda a evitar relatórios duplicados e fornece informações sobre se o bug foi reconhecido ou corrigido.
Validando o problema
Para confirmar que seu problema é um bug reproduzível e não específico da sua configuração:
- Teste em try.discourse.org: Use o sandbox padrão em try.discourse.org para ver se você consegue replicar o problema.
- Use o canal
latest: Se você estiver testando em sua própria instância do Discourse, certifique-se de usar olatestbranch
Etapas avançadas (opcional)
- Envie um Pull Request: Se você for capaz, envie um pull request com um teste com falha que demonstre o bug.
- Corrija o bug você mesmo: Se preferir resolver o problema por conta própria, siga o Contributing to Discourse development.
Criando um relatório de bug detalhado
Finalmente, se o problema persistir e você o confirmou no ambiente de teste:
- Abra um tópico na categoria de bugs: Vá para a categoria de bugs no Meta e crie um novo tópico.
- Inclua etapas reproduzíveis: Detalhe tudo o que você sabe sobre o bug, incluindo as etapas para reproduzi-lo. Consulte o guia sobre como escrever um bom relatório de bug para obter dicas sobre quais informações incluir.
Assim que o bug for corrigido, você geralmente pode esperar atualizações publicadas no tópico de relatório.