Aiuto:Come segnalare un bug

Questa pagina spiega come scrivere una buona segnalazione di errore o richiesta di nuova funzionalità nel sistema di tracciamento bug di Wikimedia (vedi Phabricator per maggiori informazioni). Segnalazioni efficaci di errori possono garantire a questi ultimi maggiori probabilità di essere corretti.

Raccomandazioni veloci sulle segnalazioni

• Sii preciso;
• Sii chiaro: spiega come appare il problema, passo per passo, affinchè altri possano riprodurre il bug;
• Affronta un singolo problema in ogni report.

Prima di fare qualcosa

Uno screenshot dell'interfaccia di Bugzilla

Puoi riprodurre il problema?

Prova a riprodurre l'errore usando una recente versione del software, per vedere se magari è già stato corretto. Se l'errore è su un wiki sito come Wikipedia, puoi provare a testarlo sulla più recente versione del software su test2.wikipedia.org.

Qualcun altro ha già segnalato la questione?

Usa la casella di ricerca su phabricator.wikimedia.org per vedere se l'errore è già stato segnalato. Puoi fare anche una ricerca avanzata qui. Nota che anche mentre compili la segnalazione, il sistema cerca in automatico eventuali "doppioni", il che comporta un passaggio in meno per te.

Segnalare un nuovo bug o una richiesta di nuova funzionalità

Se hai familiarità con il sistema ma non conosci la nuova modalità guidata di segnalazione, guarda questo video (a partire da 2:25).

Se hai incontrato un problema nell'ultima versione del software e non sembra che altri lo abbiano già riportato, allora:

1. Vai su bugzilla.wikimedia.org.
2. Scegli "Enter a new bug" dalla colonna di sinistra.
3. Ti sarà chiesto di accedere (o registrarti) se non l'hai già fatto (vedi "Why must I register?").
4. Seleziona il software in cui hai riscontrato il bug:

   potrebbe essere VisualEditor per la nuova interfaccia di modifica, MediaWiki per il software base del sito, o Wikimedia per modifiche alla configurazione dei siti Wikimedia.

5. Compila i campi che seguono:
   • Component (componente): è la parte del software interessata dal bug. Sulla destra sono presenti le descrizioni per ogni componente. Se nessuna sembra essere adatta o non sai cosa scegliere, usa semplicemente General/Unknown.
   • Severity (gravità): non è generalmente necessario modificare questo campo a meno che, invece che segnalare un problema, non si stia richiedendo una nuova funzionalità. In questo caso basterà selezionare enhancement.
   • Summary (oggetto): un breve riassunto in una sola frase che descrive il problema (non la soluzione suggerita).
     • Esempio valido: "La selezione del genere nelle Preferenze non funziona."
     • Esempio troppo vago: "Il software si blocca."
   • Description (descrizione): tutti i dettagli sul problema, con tutti i particolari possibili. Questo può includere:
     • Informazioni base come nome e versione del browser, sistema operativo, skin in uso e pagina su cui si è verificato il problema, per evitare che gli sviluppatori le richiedano in un secondo tempo e che i tempi per la soluzione del bug si dilatino ulteriormente. Se vuoi lanciarti in ardite ipotesi su cause e possibili soluzioni, sei il benvenuto.
     • Sequenza per riprodurre il problema: sequenza di azioni, semplice da seguire, che innescherà il problema descritto (passaggio opzionale, ma caldamente raccomandato). Includi i passaggi sull'eventuale configurazione necessaria.

       Esempio:

       1. Andare su https://en.wikipedia.org con Internet Explorer versione 10.0;
       2. accertarsi di essere loggati;
       3. cliccare sul link "Preferences";
       4. raggiungere la sezione "Internationalisation" e contrassegnare l'opzione She edits wiki pages;
       5. cliccare su 'Save'.

     • Risultato: quello che si è ottenuto seguendo la sequenza soprindicata.

       Esempio:

       "Il genere femminile non appare prima del mio nome utente."

     • Risultato atteso: quello che ci si aspettava di ottenere, se non si fosse verificato il bug.

       Esempio:

       "L'indicazione del mio genere è correttamente presente."

   • Allegato: puoi allegare un file di log, uno screenshot e persino brevi video (oppure caricarli su siti esterni e puoi linkarli), accertandoti prima che nessun dato confidenziale sia incluso o mostrato (passaggio opzionale ma raccomandato).

Dopo aver controllato che la segnalazione sia completa puoi premere il pulsante "Submit bug". Quest'ultima viene così salvata nel database e presto qualcuno dovrebbe darle un'occhiata. Aggiungendo il proprio indirizzo alla CC list si ricevono notifiche automatiche via email ogni volta che il bug viene aggiornato.

È tutto! Grazie di averci aiutato a migliorare MediaWiki e i progetti di Wikimedia!

Pagine correlate

• Wikipedia:Officina

Collegamenti esterni

• Writing a good bug report or feature request, di Samuel Tarling, su come usare efficacemente Phabricator
• Come segnalare bug efficacemente di Simon Tatham - simpatico articolo, tradotto in italiano, sull'importanza e la semplicità di stilare una segnalazione chiara.