Este é um guia para relatar bugs encontrados no Discourse usando os canais corretos.
Nível de usuário necessário: Qualquer pessoa pode relatar bugs
Quando você encontrar um problema que quebra ou impede o uso normal do Discourse, é crucial relatar esse bug para que ele possa ser corrigido. Relatar bugs ajuda a melhorar a plataforma para todos — esta documentação irá guiá-lo pelo processo de relatar um bug de forma eficaz no Meta, uma excelente maneira de contribuir para o Discourse.
Resumo
Neste guia, você aprenderá:
- Como garantir que o bug não tenha sido resolvido
- Como validar o problema no ambiente de teste oficial do Discourse
- Como criar um relatório de bug detalhado
Garantindo que o bug não tenha sido resolvido
Antes de relatar um bug, procure na categoria de bugs no Meta por problemas semelhantes para garantir que ele não tenha sido relatado anteriormente. 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ê pode reproduzir o problema.
- Use o canal
latest: Se você estiver testando em sua própria instância do Discourse, certifique-se de usar a ramificaçãolatest
Etapas avançadas (opcional)
- Envie uma Pull Request: Se você for capaz, envie uma pull request com um teste falho que demonstre o bug.
- Corrija o bug você mesmo: Se preferir resolver o problema por conta própria, siga as diretrizes em Contributing to Discourse development.
Criando um relatório de bug detalhado
Finalmente, se o problema persistir e você confirmá-lo 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: Descreva 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 dicas sobre quais informações incluir.
Uma vez que o bug for corrigido, você geralmente pode esperar atualizações no tópico de relatório.