Come scrivere una segnalazione di bug con esempi
Luca Bennett
⚡ Riepilogo intelligente
La redazione di report sui bug è un'abilità di test essenziale che documenta chiaramente i difetti, accelera le correzioni e migliora la qualità del software fornendo agli sviluppatori passaggi riproducibili, informazioni su gravità, priorità, dettagli dell'ambiente e allegati di supporto durante l'intero ciclo di vita del test del software.
Cos'è la segnalazione di bug? Perché hai bisogno di una buona segnalazione di bug?
Il Bug Report è un documento importante nel ciclo di vita del test del software (STLC) che offre diversi vantaggi al team di test. Mantiene tracrileva tutti i difetti, i bug multipli, gli errori e le altre discrepanze riscontrate durante i test del software e li segnala.
Lo scopo di questa documentazione post-test è fornire informazioni al team di professionisti interessato sul livello di bug riscontrati durante il processo di test.
ingegnere di sviluppo software Questo tipo di report consente di essere informati di tutti i difetti e i problemi presenti nel software. Permette inoltre di capire cosa c'è di sbagliato in un bug, in modo da poter utilizzare il metodo migliore per risolverlo. Aiuta anche a risparmiare tempo e denaro.ping In questo modo si individuano bug e problemi.
Perché dovresti preoccuparti delle buone spiegazioni dei bug?
Ecco il punto che devi considerare per scrivere una segnalazione di bug software valida e dettagliata:
- Funziona come una guida per evitare lo stesso bug nelle versioni future.
- Risparmia tempo per la comunicazione (e-mail, chiamate).
- Less lavorare per gli sviluppatori (faranno esattamente quello che vuoi).
- Avrai meno colli di bottiglia nel progetto; i bug verranno risolti in modo più rapido ed efficiente.
- Team moderni che utilizzano Jira, Linear o Azure DevOps può anche collegare le segnalazioni di bug ai ticket di sprint e alle pipeline di rilascio, garantendo tracFacilità di integrazione nei flussi di lavoro di QA e DevOps.
Come scrivere una segnalazione di bug (modello di segnalazione di bug)
Non esiste un modello esatto per la segnalazione di bug, poiché dipende dal tipo di bug.tracSistema King. Il tuo modello potrebbe essere diverso.
Tuttavia, i seguenti campi comuni sono sempre necessari quando si desidera scrivere una segnalazione di bug:
- ID/titolo del bug.
- Gravità e priorità.
- Descrizione
- Ambiente
- Passaggi per riprodursi.
- Risultato atteso.
- Risultato attuale.
- Allegati (screenshot, video, testo)
Diamo un'occhiata a tutti questi insetti-tracComponenti principali uno per uno:
1) Titolo/ID bug:
Ad ogni bug dovrebbe essere assegnato un numero identificativo univoco. Gli strumenti di segnalazione dei bug dovrebbero essere numeri univoci per i bug appena rilevati in modo da poter identificare facilmente il bug.
Esempi:
❌ Difetto: "Non riesco a vedere il prodotto quando lo ripeto, dico di no."
- Onda
- Aggressive
- Troppo prolisso
chiede che venga attuata una soluzione.
✅ Buono: “CARRELLO – Nuovi articoli aggiunti al carrello che non compaiono”.
- Questo tipo di titolo individua immediatamente il problema (CART)
- Si concentra sul problema tecnico reale.
2) Gravità del bug:
La gravità del bug è un fattore molto importante nella segnalazione del bug. Descrive l'effetto del difetto sulle prestazioni dell'applicazione.
- Bloccanti: Questo errore causa il fallimento dell'app.
- Maggiore: Un errore critico indica un cambiamento importante nella logica aziendale.
- Minor: Un problema che non influisce sulla funzionalità dell'applicazione ma influisce sui risultati attesi.
- Banale: Non influisce sulla funzionalità o sul funzionamento dell'app. Potrebbe essere un errore tipografico.
3) Priorità del bug:
Di seguito è riportata la gradazione generale per decidere la priorità dei bug:
- Alto: Copre tutto ciò che influisce sul flusso o blocca l'utilizzo dell'app.
- Medium: Influisce negativamente sull'esperienza dell'utente.
- Minor: Tutti gli altri errori come (errori di battitura, icone mancanti, problemi di layout, ecc.).
4) Ambiente:
Un Bug può comparire in un ambiente specifico e non in altri. Ad esempio, a volte viene visualizzato un bug durante l'esecuzione del sito Web Firefoxo un malfunzionamento dell'app solo quando è in esecuzione su un Android dispositivo e funziona bene su iPhone.
Queste segnalazioni di bug possono essere identificate solo con test cross-browser o cross-device. Pertanto, quando segnalano il bug, i QA dovrebbero essere in grado di specificare se il bug deve essere osservato in uno o più ambienti specifici.
5) Sommario:
Tuttavia, aggiungere solo il titolo alla segnalazione di bug non è sufficiente. Pertanto, se il titolo non è abbastanza esaustivo, è possibile aggiungere un breve riepilogo della segnalazione.
Il tuo riepilogo nel minor numero di parole possibile, incluso quando e come si è verificato il bug. Il titolo e la descrizione del bug dovrebbero essere utilizzati anche nelle ricerche, quindi devi assicurarti di aver coperto parole chiave importanti.
Esempi:
- Bad: "Stavo cercando di aggiungere elementi al test e non è apparso nulla quando l'ho fatto o ho cliccato sul pulsante."
- Buono: “Quando ho provato ad aggiungere [PRODOTTO] al negozioping Ho aggiunto il prodotto al carrello, ma non è successo nulla quando ho cliccato sul pulsante "aggiungi" nella pagina di presentazione del prodotto.
6) Passaggi per riprodurre:
Quando si segnala un bug, è importante specificare i passaggi per riprodurlo. È inoltre necessario includere le azioni che potrebbero causarlo. In questa fase, è bene evitare affermazioni generiche.
Sii specifico sui passaggi da seguire:
Ecco un esempio di procedura ben scritta:
Passi:
- Seleziona il prodotto X1.
- Clicca su Aggiungi al carrello.
- Fare clic su Rimuovi per rimuovere il prodotto dal carrello.
7) Risultato atteso:
Nelle segnalazioni di bug, è importante descrivere il risultato atteso in base all'attività tecnica, alla progettazione dei risultati del test case o in base all'opinione del tester. Tutto ciò aiuta gli sviluppatori a concentrarsi sulla ricerca rapida delle informazioni necessarie.
Per esempio:
I campi obbligatori devono essere evidenziati in rosso dopo aver fatto clic sul pulsante "Invia".
8) Risultato effettivo:
Come suggerisce il nome, questo campo descrive l'effetto reale del bug. È molto importante scrivere una descrizione chiara del risultato effettivo.
Per esempio:
I campi obbligatori vengono evidenziati in verde dopo aver fatto clic sul pulsante "Invia".
9) Allegati (screenshot e video):
Nelle segnalazioni di bug, è buona pratica allegare file alle segnalazioni di bug che rendono più facile percepire le informazioni quando è necessario visualizzarle visivamente:
Per esempio:
- Screenshot: Gli screenshot possono facilmente elaborare errori nel programma; È utile quando il bug è evidenziato con un'annotazione specifica, un cerchio o un'immagine a forma di freccia).
- Video: A volte è difficile descrivere un bug a parole, quindi è meglio creare un video in modo che lo sviluppatore possa correggere il difetto nel programma.
10) Versione interessata:
Si tratta della versione software interessata in cui viene segnalato il bug.
11) Versione corretta:
È la versione del software in cui il bug è stato risolto. Pertanto, quando il QA che ha segnalato il bug controlla se è stato corretto, utilizza la versione software corretta.
12) Target Versione:
La versione di destinazione in cui un bug dovrebbe essere preso di mira per essere corretto. Pertanto, quando il team di sviluppo lavora per correggere un bug, si rivolge principalmente a una particolare versione dell'applicazione.
13) Data di chiusura:
È la data in cui il bug viene chiuso dal team di testing del software. La chiusura di un bug è una parte vitale e integrante del test del software.
14) Stato:
Quando viene creato un nuovo bug, il suo stato dovrebbe essere aperto. Successivamente, passa attraverso fasi come In Progress, Fixed, Running, Reopen, ecc.
Suggerimenti per la scrittura di segnalazioni di bug
Ecco alcuni suggerimenti importanti che dovresti ricordare mentre scrivi una segnalazione di bug efficace:
- Quando create segnalazioni di bug, siate precisi. Assicuratevi di non includere informazioni inutili o irrilevanti.
- È necessario segnalare immediatamente il bug non appena viene rilevato.
- Preparare il rapporto in dettaglio per consentire allo sviluppatore di utilizzare i fatti e le informazioni per eseguire il debug del problema.
- Dovresti testare la stessa occorrenza di bug su altri moduli simili per la convalida.
- RevVisualizzare la segnalazione del bug almeno una volta prima di inviarla.
- Dovresti assicurarti che la segnalazione del bug contenga la descrizione di un solo errore.
- Infine, non dovresti aver paura di chiedere aiuto al Project Manager se non ti è chiaro qualcosa.
- Utilizza le funzionalità di triage basate sull'intelligenza artificiale in Jira o Linear per classificare automaticamente la gravità, suggerire duplicati e instradare il report al responsabile del componente corretto.
Strumenti di segnalazione bug
Il processo di segnalazione dei bug, eseguito manualmente, viene ora eseguito con vari strumenti di segnalazione dei bug disponibili sul mercato.
- Jira
- Lineare
- Azure DevOps
- Zoho Bug Tracker
- Bugzilla
Puoi controllare la nostra recensione dettagliata del il miglior strumento di segnalazione dei bug.
Problema comune e soluzione durante la scrittura di una segnalazione di bug:
Ecco alcuni problemi comuni e le relative soluzioni durante la scrittura di una segnalazione di bug:
| Esempio di segnalazione di bug | Problema |
|---|---|
| Moltiplicando 2 per 3 la risposta sarà positiva. | Riporta lo schema, non un esempio. |
| L'elenco verrà ordinato in ordine alfabetico quando si aggiunge un nuovo elemento per evitare ciò. | Non limitarti a descrivere cosa c'è di sbagliato |
| Per esempio: Per iniziare, dovrai aprire il tuo browser e digitare l'indirizzo del sito URLTroverete il primo campo, 'username', scritto in modo errato. |
Sempre diretto al punto (non raccontare mai la storia!). |
| Il nome del cliente nel report è scritto in modo errato. Priorità: alta, gravità: alta | Non mischiare mai priorità e severità. |
| La formula per il calcolo delle tasse è SBAGLIATA!!?? | Non utilizza MAIUSCOLE, lettere rosse, cerchi rossi, '!', |
| Non credo che il design dell'interfaccia utente della home page sia valido. | Non usare il tuo giudizio. |
| Esempio di descrizione poco chiara: riguardo alla discussione di oggi, esegui l'azione richiesta per questa pagina. | Rendi la tua descrizione comprensibile a tutti. |
| Lo sfondo della pagina deve essere blu, arancione o verde oppure puoi renderlo bianco o nero.
Questo non va bene perché non è chiaro cosa sia necessario al team di sviluppo e progettazione web |
Riduci al minimo le opzioni |
| La formula per il calcolo delle imposte a volte non funziona come previsto. | La regola d'oro: non usare la parola "a volte". |
Esempio di segnalazione di bug
Ecco un piccolo esempio di segnalazione di bug:
[IL MIO ACCOUNT] La sottolineatura viene visualizzata quando si passa il mouse sul pulsante Aggiorna.
Descrizione: Dobbiamo rimuovere la sottolineatura quando passiamo il mouse sul pulsante Aggiorna nella sezione Il mio account.
link: http://test.com/mv-account/
Browser/sistema operativo: Cromo 25. OSX Yosemite 10.10.2
Passos per riprodurre:
1. Vai su www.test.com
2. Accedi tramite credenziali di accesso
3. Vai a Il mio account
4. Passare il mouse sul pulsante Aggiorna
Risultato attuale: c'è una sottolineatura.
Risultato atteso: nessuna sottolineatura.
Dati di accesso: test@test.com / mysecretpass12
Deve evitare errori nella scrittura delle segnalazioni di bug
Ecco alcuni errori importanti che dovresti evitare mentre scrivi una segnalazione di bug:
- Non scrivere della tua insoddisfazione e non includere mai i tuoi sentimenti personali.
- È infastidito dalle persone che vogliono concentrarsi sull'attività quando sovraccarichi il tuo post con molte emoticon.
- Non sovraccaricare mai il tuo post con punti esclamativi; non accelera il lavoro.
- Nessuno vuole sentirsi offeso. Distrugge la motivazione e rallenta la realizzazione del problema.
