Potresti prendere in considerazione l'idea di prendere alcune idee da Mozilla e Sun su questo argomento:
Schema generale di una segnalazione di bug
Riepilogo : come descriveresti il bug in meno di 60 caratteri? Dovrebbe identificare rapidamente e in modo univoco una segnalazione di bug, nonché spiegare il problema, non la soluzione suggerita.
Buono : "L'annullamento di una finestra di dialogo Copia file provoca l'arresto anomalo di File Manager"
Cattivo : "Il software si arresta in modo anomalo"
Cattivo : "Il browser dovrebbe funzionare con il mio sito Web"
Componente : in quale sotto-parte del software esiste? Questo campo è obbligatorio per inviare qualsiasi segnalazione di bug. Fare clic sulla parola "Componente" per visualizzare una descrizione di ciascun componente. Se nessuno sembra appropriato, evidenziare il componente "Generale".
OS : da quale sistema operativo (OS) l'hai trovato? (ad es. Linux, Windows XP, Mac OS X.) Esempio: "Se sai che il bug si verifica su più di un tipo di sistema operativo, scegli" Tutto ". Se il tuo sistema operativo non è elencato, scegli Altro ”.
Descrizione : i dettagli della segnalazione del problema, tra cui:
- Panoramica : si tratta di una rivisitazione dettagliata più ampia del riepilogo. Un esempio potrebbe essere: "La selezione trascinata di qualsiasi pagina si arresta in modo anomalo su build Mac nella funzione NSGetFactory".
- ID build : per trovarlo, vai alla pagina “about:” tramite la barra degli indirizzi oppure, se hai l'estensione Strumenti notturni di MozQA Tester, vai su Strumenti | Strumenti Nightly Tester e selezionare l'opzione che contiene l'output dell'ID build. Dovrebbe assomigliare a questo: "Mozilla / 5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv: 1.9.1b3) Gecko / 20090305 Firefox / 3.1b3 ″.
- Build e piattaforme aggiuntive : indipendentemente dal fatto che il bug si verifichi o meno su altre piattaforme (o browser, se applicabile). Dovrebbe assomigliare a questo: "Non si verifica su Mozilla / 5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv: 1.9.1b3) Gecko / 20081107 Firefox / 3.1b2 ″.
Passaggi da riprodurre : passaggi minimizzati e facili da seguire che attiveranno il bug. Se sono necessari, assicurati di includere eventuali passaggi di installazione speciali. Un buon esempio di questo sarebbe simile al seguente: 1) Visualizza qualsiasi pagina web. (Ho usato la pagina di esempio predefinita,
http://www.google.com/ ). 2) Trascina e seleziona la pagina. In particolare, tenendo premuto il pulsante del mouse, trascinare il puntatore del mouse verso il basso da qualsiasi punto nell'area di contenuto del browser nella parte inferiore dell'area di contenuto del browser.
Risultati effettivi : cosa ha fatto l'applicazione dopo aver eseguito i passaggi precedenti. Un esempio potrebbe essere: l'applicazione si è arrestata in modo anomalo.
Risultati previsti : cosa avrebbe dovuto fare l'applicazione, se il bug non fosse presente. Un esempio potrebbe essere: la finestra dovrebbe scorrere verso il basso. Il contenuto fatto scorrere dovrebbe essere selezionato. O almeno l'applicazione non dovrebbe arrestarsi in modo anomalo.