Questa è una guida per segnalare i bug che trovi in Discourse utilizzando i canali corretti.
Livello utente richiesto: Chiunque può segnalare bug
Quando riscontri un problema che interrompe o impedisce il normale utilizzo di Discourse, è fondamentale segnalare questo bug in modo che possa essere affrontato e risolto. La segnalazione di 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 convalidare il problema sull’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. Ciò aiuta a evitare segnalazioni duplicate e fornisce informazioni sul fatto che il bug sia stato riconosciuto o risolto.
Convalida del problema
Per confermare che il tuo problema è un bug riproducibile e non specifico della tua configurazione:
- Testa su try.discourse.org: Utilizza l’ambiente sandbox predefinito su try.discourse.org per vedere se riesci a replicare il problema.
- Usa il canale
latest: Se stai testando sulla tua istanza di Discourse, assicurati di utilizzare ilbranch latest
Passaggi avanzati (facoltativo)
- 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 risolvere il problema da solo, segui Contributing to Discourse development.
Creazione di una segnalazione di bug dettagliata
Infine, se il problema persiste e l’hai confermato sull’ambiente di test:
- Apri un argomento nella categoria bug: Vai alla categoria bug su Meta e crea un nuovo argomento.
- Includi i passaggi riproducibili: Dettaglia tutto ciò che sai sul bug, inclusi i passaggi per riprodurlo. Fai riferimento alla guida su come scrivere una buona segnalazione di bug per suggerimenti sulle informazioni da includere.
Una volta risolto il bug, generalmente puoi aspettarti che gli aggiornamenti vengano pubblicati nell’argomento di segnalazione.