Come segnalare un bug
- To ask technical questions about Wikimedia projects, see m:Tech
- To ask technical questions about MediaWiki in non-WMF installations, see Project:Support desk
Queste linee guida spiegano come segnalare efficacemente un bug o richiedere una nuova funzionalità utilizzando il phab: Bugtracker di Wikimedia (vedi Phabricator per maggiori informazioni). La segnalazione efficace di un bug è la premessa indispensabile per una sua tempestiva correzione. Le attività devono essere scritte in inglese. Se non puoi scrivere in inglese, prova a usare un traduttore come Traduttore Google.
Raccomandazioni veloci sulle segnalazioni
- Sii preciso
- Sii più che chiaro/a: spiega 1) come riprodurre la situazione, passo dopo passo, senza lasciare alcuno spazio per l'interpretazione, 2) comportamento atteso, 3) comportamento effettivo. In sezioni separate
- Includi solo un problema per task
- Includi tutti i link e gli esempi che possono essere utili
Prima di fare qualsiasi cosa
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 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 nel bugtracker di Wikimedia per verificare che l'errore non sia già stato segnalato. Puoi anche eseguire ricerche avanzate nella pagina di ricerca.
Se non sei sicuro che un bug sia già stato riportato, dovresti riportare il bug. Meglio avere bug duplicati che avere bug non riportati
È forse un problema con un gadget / script di utente?
Alcuni problemi sono conseguenza dell'uso di scripts di utente e gadgets che necessitano alcune correzioni. C'è una guida disponibile con passi su come identificare tale codice, che potrebbe risolvere il tuo problema senza farti perdere tempo con una segnalazione.
Si tratta di un problema di cache?
Alcuni problemi sono dovuti a vecchio codice HTML memorizzato nella cache che viene servito insieme al nuovo JavaScript mentre sono incompatibili. Per determinare se questa è la causa è utile fare il purge, aggiornare la pagina e vedere se il problema persiste e includere queste informazioni nella segnalazione del bug.
Segnalare un nuovo bug o richiedere una nuova funzionalità
Se in una recente versione del software hai incontrato un bug che apparentemente non è ancora stato segnalato, allora:
- Vai su phabricator.wikimedia.org.
- Se non hai ancora effettuato l'accesso, ti verrà chiesto di farlo (o di registrarti - vedi "creare una utenza ").
- Clicca sul bottone Segnalibro nell'angolo in alto a destra e scegli "Report a Software Bug" (o "Report Security issues" per riportare un problema di sicurezza ).
- Compilare almeno i seguenti campi:
- Sommario: Una breve sintesi di una frase che spiega il problema (non la soluzione che suggerisci).
- Buono:
"Selecting gender is not functional on Special:Preferences"
- Cattivo:
"Software crashes"
- Buono:
- Descrizione: Dettagli completi del problema, fornendo tutte le informazioni attualmente disponibili. Se ciò non è sufficiente, ti verranno richieste ulteriori informazioni insieme a indicazioni su come ottenerlo. Questo campo dovrebbe contenere:
- Per segnalare bug:
- Procedura per la Riproduzione: Procedura minimizzata, semplice da seguire che ti permetterà la descrizione del problema. Include ogni procedura speciale di setup.
- Esempio:
Go to https://en.wikipedia.org with Internet Explorer version 10.0;
Make sure you are logged in;
Select "My Preferences" menu;
Go to "Gender" and select female gender from box list;
Click "Save" button.
- Esempio:
- Risultati Effettivi: Ciò che l'applicazione ha fatto dopo l'esecuzione della procedura sopra descritta.
- Esempio:
"There is no female gender in front of my username."
- Esempio:
- "Risultati Attesi" Quello che l'applicazione dovrebbe dovuto fare, se non ci fosse stato nessun problema.
- Esempio:
"My gender is shown in front of my username."
- Esempio:
- Procedura per la Riproduzione: Procedura minimizzata, semplice da seguire che ti permetterà la descrizione del problema. Include ogni procedura speciale di setup.
- Per richieste di funzionalità:
- Una descrizione di cosa vorresti ottenere, e perché. Spiega cosa speri che la caratteristica risolva (il reale problema di fondo) insieme ad esempi concreti; non aggiungere però una soluzione concreta in quanto potrebbero esserci migliori soluzioni. Un modo efficace per descriverlo è tramite la storia di un utente.
- Esempio:
"As a new editor, I would like to be acknowledged for my contribution to the project, so that I feel welcomed and valued"
- Esempio:
- Una descrizione di cosa vorresti ottenere, e perché. Spiega cosa speri che la caratteristica risolva (il reale problema di fondo) insieme ad esempi concreti; non aggiungere però una soluzione concreta in quanto potrebbero esserci migliori soluzioni. Un modo efficace per descriverlo è tramite la storia di un utente.
- Fornisci cortesemente ogni altra informazione che potrebbe risultare utile, come ad esempio:
- I browsers web, skins, o i sistemi di computer in cui ha riscontrato il bug;
- links o diffs a una o più pagine in cui avete incontrato il bug; o
- Se il problema appare in continuazione, occasionalmente, solo in certe pagine o solamente in circostanze specifiche.
- Per segnalare bug:
- Per allegare un log file o screenshot (ma assicurati che non siano inclusi o mostrati dati riservati), clicca il pulsante Upload File (una nuvoletta con una freccia) nella barra strumenti del campo Descrizione.
- Seleziona l'etichetta (del "progetto/progetti") nel quale hai trovato il bug:
- I progetti sono: come gli sviluppatori trovano gli obiettivi da completare su cui lavorare. Per identificare i/il giusti/o progetti/o, usare la funzione cerca (in alto a destra) per trovare la sua descrizione
- Per esempio questo potrebbe essere
MediaWiki-General
per il software della stessa wiki, oWikimedia-Site-Requests
per modifiche alla configurazione di siti wiki di Wikimedia (vedi Selecting projects ).
- "CC:" se conosci un utente specifico che potrebbe essere interessato a ricevere una notifica di questa attività puoi aggiungerlo qui. Altrimenti, ignora questo campo.
- Sommario: Una breve sintesi di una frase che spiega il problema (non la soluzione che suggerisci).
Dopo aver controllato che la segnalazione sia completa, premere il pulsante "Create Task" ("Crea un compito"). La tua segnalazione sarà salvata nel database. Questo permette che qualcuno interessato nella segnalazione lo revisioni e potenzialmente possa lavorarci .
La priorità per una attività sara assegnata dagli sviluppatori che intendono lavorare al progetto (vedi Setting_priorities|Assegnazione priorità).
È tutto! Grazie per il tuo aiuto nel migliorare MediaWiki e i progetti di Wikimedia!
Riportare un JavaScript bug
- Vedi anche: Aiuto:Trovare gli script malfunzionanti
Molte funzionalità come gadget, script di utente e alcune parti di MediaWiki, si basano su JavaScript.
Quando trovi un bug che può essere relazionato con JavaScript, fai del tuo meglio per identificare i messaggi di errore e copiarli nel rapporto dell'errore.
È molto importante dare tutte le informazione che hai, perchè anche l'amministratore di sistema non avrà accesso ad alcun log di errore.
Se il problema si trova nel codice di uno script utente o di un gadget, allora Phabricator potrebbe non essere il luogo in cui verrà gestito il problema.[1] Qualcuno potrebbe reindirizzarti alla conversazione pagina dello script (se lo script problematico è identificato).
Segnalazione di un problema di connettività
Se hai difficoltà a raggiungere un sito Wikimedia (connessione internet lenta, ecc.), segui https://wikitech-static.wikimedia.org/wiki/Reporting_a_connectivity_issue.
Segnalazione di un problema di accesso
Se hai problemi ad accedere al tuo account, segui Manual:How to debug/Login problems .
Note