Questa è una guida per segnalare i bug che trovi in Discourse utilizzando i canali corretti.
Livello utente richiesto: Chiunque può segnalare bug
Quando incontri un problema che rompe o impedisce l’uso normale di Discourse, è fondamentale segnalare questo bug in modo che possa essere affrontato e risolto. Segnalare i bug aiuta a migliorare la piattaforma per tutti: questa documentazione ti guiderà attraverso il processo di segnalazione efficace di un bug su Meta, un ottimo modo per contribuire a Discourse.
Riepilogo
In questa guida imparerai:
- Come assicurarti che il bug non sia già stato risolto
- Come validare il problema nell’ambiente di test ufficiale di Discourse
- Come creare una segnalazione di bug dettagliata
Assicurarsi che il bug non sia già stato risolto
Prima di segnalare un bug, cerca nella categoria bug su Meta problemi simili per assicurarti che non sia già stato segnalato. Questo aiuta a evitare segnalazioni duplicate e fornisce informazioni su se il bug è stato riconosciuto o risolto.
Validare il problema
Per confermare che il tuo problema sia un bug riproducibile e non specifico della tua configurazione:
- Testa su try.discourse.org: Usa il sandbox predefinito su try.discourse.org per vedere se puoi replicare il problema.
- Usa il canale
latest: Se stai testando sulla tua istanza di Discourse, assicurati di usare il ramolatest
Passaggi avanzati (opzionali)
- Invia una Pull Request: Se sei in grado, invia una pull request con un test fallito che dimostri il bug.
- Risolvi il bug da solo: Se preferisci affrontare il problema da solo, segui le Contributing to Discourse development.
Creare una segnalazione di bug dettagliata
Infine, se il problema persiste e lo hai confermato nell’ambiente di test:
- Apri un argomento nella categoria bug: Vai alla categoria bug su Meta e crea un nuovo argomento.
- Includi passaggi riproducibili: Dettagli tutto ciò che sai sul bug, inclusi i passaggi per riprodurlo. Consulta la guida su come scrivere una buona segnalazione di bug per suggerimenti su quali informazioni includere.
Una volta risolto il bug, puoi generalmente aspettarti che gli aggiornamenti vengano pubblicati nell’argomento di segnalazione.