KjerrUn template per bug report
da copiare.
Un buon template per bug report porta uno sviluppatore dalla lettura alla riproduzione in un solo passaggio: cosa è successo, cosa doveva succedere, i passi e dove. Copia il template qui sotto in un documento, un modulo o un issue tracker, oppure imposta gli stessi campi su una board che accetta anche i file.
Il template per bug report
Sette domande. Rendi obbligatori il titolo e i passi; lascia il resto facoltativo.
Titolo
Cosa non funziona e dove. Una frase.
Esempio: L’esportazione in CSV scarica un file vuoto
Cosa è successo?
Cosa vedi, in una o due frasi.
Cosa ti aspettavi?
Cosa doveva succedere invece.
Passi per riprodurlo
1.
2.
3.
Quanto spesso?
Ogni volta, a volte o una volta sola.
Dove?
Browser o versione dell’app, sistema operativo, account o workspace.
Hai qualcosa da mostrare?
Uno screenshot, una registrazione dello schermo, un log, un file HAR.
Un esempio di bug report
Lo stesso template, compilato. Il prodotto e i numeri sono inventati.
Titolo
L’esportazione in CSV scarica un file vuoto
Cosa è successo?
Ho cliccato Esporta nella pagina Report. Il file si è scaricato,
ma contiene solo la riga di intestazione.
Cosa ti aspettavi?
Le 214 righe che si vedono nella tabella sullo schermo.
Passi per riprodurlo
1. Apri Report e scegli gli ultimi 30 giorni.
2. Filtra per il piano “Scale”.
3. Clicca Esporta, poi CSV.
Quanto spesso?
Ogni volta con il filtro attivo. Senza filtro l’esportazione funziona.
Dove?
Chrome 141 su macOS 15. Workspace: northwind.
Hai qualcosa da mostrare?
export.csv (il file vuoto), reports.har
A cosa serve ogni campo
- Titolo. Cosa non funziona e dove, così la segnalazione si ritrova e i duplicati si incontrano.
- Cosa è successo? Il sintomo con le parole di chi segnala, prima che qualcuno lo interpreti.
- Cosa ti aspettavi? Metà delle segnalazioni sono un malinteso, e questa riga mostra quale metà.
- Passi per riprodurlo. La parte che uno sviluppatore non può indovinare. Numerati, un’azione per passo.
- Quanto spesso? “Ogni volta” indica la logica; “a volte” indica i tempi o i dati.
- Dove? Browser, versione e account restringono la ricerca più di qualsiasi descrizione.
- Hai qualcosa da mostrare? Una registrazione o un log sostituiscono tre paragrafi.
Come trasformare il template in un modulo per segnalare bug
Un modulo per segnalare bug dovrebbe chiedere meno del template. Ogni campo obbligatorio costa qualche segnalazione, e una segnalazione mancante costa più di un dettaglio mancante.
- Rendi obbligatori il titolo e i passi per riprodurlo, nient’altro.
- Metti un esempio nel segnaposto di ogni campo, così si vede il livello di dettaglio che vuoi.
- Mostra le segnalazioni simili prima dell’invio, così si può aggiungere un voto e non un duplicato.
- Lascia allegare i file trascinandoli sul modulo.
- Dì cosa succede dopo: dove comparirà la segnalazione e come arriverà la risposta.
Cosa allegare a una segnalazione di bug
Le prove accorciano la conversazione. Questi sono i file che vale la pena chiedere, e cosa chiarisce ciascuno.
- Uno screenshot, per tutto quello che si vede.
- Una registrazione dello schermo in MP4, quando i passi sono difficili da mettere in parole.
- Un file HAR, quando una pagina non si carica, non salva o non esporta.
- Un log della console o del server come TXT o LOG.
- L’email stessa come EML, per problemi di consegna e formattazione.
- Il file CSV, XLSX o JSON che non si è importato, o quello uscito sbagliato.
Raccogliere bug report su una board Kjerr
Una board Kjerr può fare le domande del template e conservare le prove. Cosa c’è di nuovo il team lo vede dove avviene la gestione del feedback.
- Il modulo è modificabile: aggiungi “Passi per riprodurlo”, “Cosa ti aspettavi” e “Dove” come campi tuoi, fino a 10 campi in tutto, ciascuno obbligatorio o facoltativo e con il suo segnaposto.
- Fino a 5 file da 10 MB su una segnalazione o un commento: immagini, PDF, EML, TXT, LOG, CSV, JSON, HAR, ZIP, DOCX, XLSX, PPTX e MP4.
- Le segnalazioni simili compaiono mentre si scrive il titolo, ognuna con il pulsante per votare.
- Per una board di QA, rendila riservata agli iscritti e limita l’accesso al dominio email dell’azienda; è la stessa configurazione di una cassetta dei suggerimenti digitale.
- Quando lo stato passa a Shipped, chi ha segnalato e tutti quelli che hanno votato ricevono un’email.
- Non è un issue tracker: niente assegnatari, livelli di gravità o sprint.
Domande, con risposte chiare.
Cos’è un template per bug report?
Un template per bug report è un insieme fisso di domande che ricava da ogni segnalazione gli stessi fatti: cosa è successo, cosa ci si aspettava, come riprodurre il problema e dove si è verificato. Permette a uno sviluppatore di passare dalla lettura alla riproduzione senza un giro di domande.
Cosa dovrebbe contenere un bug report, cioè una segnalazione di bug?
Un titolo in una frase, cosa è successo e cosa ci si aspettava, i passi numerati per riprodurlo, quanto spesso capita, l’ambiente e le prove, per esempio uno screenshot o un log. Se solo due cose possono essere obbligatorie, che siano il titolo e i passi.
Che differenza c’è tra un bug report e una feature request?
Un bug report dice che il prodotto non fa quello che promette. Una feature request chiede qualcosa che il prodotto non ha mai promesso. Richiedono domande diverse; per la seconda usa il template per le feature request.
Come si scrivono bene i passi per riprodurre un bug?
Parti da uno stato che chiunque può raggiungere, scrivi un’azione per riga e indica i valori esatti che hai digitato o scelto. Fermati al passo in cui compare il problema. Se un passo serve solo a volte, dillo.
Cos’è un file HAR e vale la pena allegarlo?
Un file HAR è la registrazione delle richieste fatte da una pagina web, salvata dagli strumenti per sviluppatori del browser. Allegalo quando una pagina non si carica, non salva o non esporta. Prima controllalo: può contenere cookie di sessione e dati personali.
Kjerr può sostituire un bug tracker?
No. Kjerr raccoglie le segnalazioni, elimina i duplicati e avvisa chi ha segnalato quando lo stato cambia. Non ha assegnatari, livelli di gravità o sprint, e non si sincronizza con Jira o Linear. I team lo usano come porta d’ingresso e tengono l’issue tracker dietro di essa.
Pagine correlate
Dai una risposta ai tuoi utenti.
Durante l’early access Kjerr è gratuito: tutte le funzionalità, nessuna carta di credito. I piani a pagamento, quando arriveranno, saranno calcolati per workspace, mai per postazione amministratore.